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About this document 


This reference manual describes all menu commands used at a maintenance 
and administration position (MAP) in a Nortel Networks DMS-100 switch. 


When to use this document 


Nortel Networks software releases are referred to as batch change 
supplements (BCS) and are identified by a number, for example, BCS29. 
This document is written for DMS-100 Family offices that have BCS36 and 


up. 


More than one version of this document may exist. The version and issue 
are indicated throughout the document, for example, 01.01. The first two 
digits increase by one each time the document content is changed to support 
new BCS-related developments. For example, the first release of a 
document is 01.01, and the next release of the document in a subsequent 
BCS is 02.01. The second two digits increase by one each time a document 
is revised and rereleased for the same BCS. 


To determine which version of this document applies to the BCS in your 
office, check the release information in DMS-100 Family Guide to Northern 
Telecom Publications, 297-1001-001. 


How to identify the software in your office 


The Office Feature Record (D190) identifies the current BCS level and the 
feature packages in your switch. You can list a specific feature package 
or patch on the MAP (maintenance and administration position) terminal by 


typing 
>PATCHER;INFORM LIST identifier 
and pressing the Enter key. 


where 
identifier is the number of the feature package or patch ID 


You can identify your current BCS level and print a list of all the feature 
packages and patches in your switch by performing the following steps. 
First, direct the terminal response to the desired printer by typing 
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>SEND printer_id 
and pressing the Enter key. 


where 
printer_id is the number of the printer where you want to print the data 


Then, print the desired information by typing 


>PATCHER;INFORM LISTLEAVE 
and pressing the Enter key. 


Finally, redirect the display back to the terminal by typing 


>SEND PREVIOUS 
and pressing the Enter key. 


How commands reference documentation is organized 


This reference manual is one of two commands reference manuals for all 
commands used at a MAP in a Nortel Networks DMS-100 switch. The 
two commands reference manuals are the following: 


297-1001-820 DMS-100 Nonmenu Commands Historical Reference Manual 
describes all nonmenu commands used at a MAP in a Nortel 
Networks DMS-100 switch. 


297-1001-821 DMS-100 Menu Commands Historical Reference Manual 
describes all menu commands used at a MAP in a Nortel 
Networks DMS-100 switch. 


What are menu and nonmenu commands 


For the commands reference documents the commands used at a MAP 
position have been divided into two categories, menu and nonmenu: 


e Menu commands are associated with a MAP display containing a 
numbered list or menu of commands and parameters when the level or 
sublevel from which the commands are entered has be accessed. 
Commands that can be executed from an accessed menu, but are not 
displayed, are called hidden commands. The level from which the 
command may be entered is referred to as its menu or menu level. 


Note 1: Menus may not always appear when a menu level or sublevel has been 
accessed, such as when displays have been suppressed with the command 
mapci nodisp. 


mapci nodisp.. 
Note 2: Hidden commands may be seen when the menu level has been 


accessed by entering the listst command and printing the top directory. 


297-1001-821 Standard 04.01 June 1999 


About this document ix 


listst. 
print dir. 


e Nonmenu commands are not associated with a MAP display, even when 
the level or sublevel from which they may be entered has been accessed. 
The level from which a nonmenu command is entered is referred to as its 
directory or directory level. 


Note: Nonmenu commands can be seen when the directory level has been 
accessed by entering the print command with the name of the directory. 


print dir. 


How this manual is organized 


The organization of this manual is designed to provide rapid access to 
comprehensive commands information, in an easy-to-use and 
easy-to-understand format. The manual has a modular structure designed 
around chapters, which group commands according to the menu from which 
they are accessed. Special tables are provided to allow quick location of any 
command. 


How volumes are organized 


The reference manual is divided into into 10 volumes. Each volume 
contains a publication history section, an about this document section, and 
the first chapter containing the reference tables. The front cover and title 
page of each volume indicates the range of command levels within that 
volume. Since menus are in alphabetical order, the volume containing the 
menu one wishes to reference is easily determined. Within volumes, page 
numbers begin with same letter of the alphabet as the menu. 


How the command reference tables chapter is organized 


The first chapter, “Commands reference tables,” includes two tables and a 
chart: 


e menu description table-contains a list of all menus in alphabetical order 
and provides a brief description of each 


e menu cross-reference table-lists all of the documented commands in 
alphabetical order and cross references them to the menu to which they 
pertain and the page where they are documented 


e menu level and sublevel chart-illustrates the hierarchical relationship 
between all menu levels and sublevels 


How the menu chapters are organized 


Each chapter following the “Commands reference tables” documents one 
menu and all its commands. The names of the chapters are the same as the 
names of the menus (levels or sublevels) which they document. The 
chapters are organized in alphabetical order. 
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Each menu chapter consists of an overview section, which introduces the 
menu level, followed by a separate section for each command. 


How the overview section is organized 
The overview section of each chapter contains the following: 


a brief description of the menu 
instructions for accessing the menu level 


a menu commands table listing all the commands available from the 
menu cross-referenced to the page where they are described 


a graphic representation of the MAP menu display, including hidden 
commands 


a status code table for the menu level 


a common responses table, included only when all or most of the 
commands at a level have many of the same responses 


other tables of common information, included only when all or most of 
the commands at a level share the same information, such as alarms or 
status displays 


How command sections are organized 
Each command section consists of the following elements in the order listed: 


a brief description of the use and function of the command 
a commands expansion table 


a qualifications section describing any special characteristics, 
exceptions, restrictions, limitations, cautions, or warnings 


an examples table 
a responses table 


What command convention is used 


The following is the description of the commands convention used in this 
manual. 


How commands are represented 


The command convention is used for two distinct representations of 
commands. One representation includes all parameters, variables, and 
syntactic relationships and is called acommand expansion. The other 
representation is of commands as they are actually entered and is called a 
command example. 
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How the convention is used in command expansions 


A special command table is used for acommand expansion. It consists of 
two sections. The first section is the command expansion itself in which the 
following characteristics are represented: 


e all parameters 

e all variables 

e hierarchy (the order in which elements must be entered) 
e syntax (specific requirements of command strings) 

e truncated and abbreviated forms, when allowed 

e defaults 


The second section is a description of all the parameters and variables. 


Command elements are represented exactly as they are to be entered in 
actual commands, except when italic font is used indicating the element is 
not entered as represented, such as for variable names and certain defaults. 


Note: Italics always indicates an element that is not entered as part of a 
command in the form in which it is shown. It is either a variable that must be 
replaced with a value, a range or another element; or, it is a default condition 
which is not entered as part of a command. 


How command words are presented 

The actual command word is represented in lowercase, boldface, except 
where uppercase is required by case sensitivity. The command appears to 
the left of all other elements in the command expansion (parameters and 
variables). 


ps_link noforce 


force wait 
unit_no nowait 


If a truncated or abbreviated form of a command is allowed, it will appear 
directly beneath the long form of the command. 


ps_link noforce 


force wait 
unit_no nowait 


Note: The b command is not a true truncated form of the bsy command and is 
used merely for illustration. 
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How parameters are presented 


Parameters are lowercase, regular type (not boldface), except where 
uppercase is required by command case sensitivity. 


ps_link noforce 


force wait 
unit_no nowait 


How variables are presented 

Variable names are in italics. Italics indicates that the variable is not entered 
as shown, but must be replaced with some other element, such as a value, 
range, number, or item from a list. 


The numbers, values, ranges, and lists that represent the substitutions or 
actual entries for variable names are not represented in the expansion of the 
command. These are described in detail for each variable in the description 
section below the expansion. 


ps_link noforce 


force walt 
unit_no nowait 


How hierarchy is presented 
The order in which elements must be entered is represented by their order of 
appearance from left to right. 


2 3 4 
ps_link noforce 


force wait 
unit_no nowait 


When several elements appear in the same horizontal position (that is, in a 
vertical list), one of them must be selected for that position, except when 
there is a default. 


ps_link noforce 


b force wait 
nowait 


select one unit_no 


How long command expansions are presented 

Some commands that have many parameters and variables with very long 
hierarchies require the expansion row to be continued. When this occurs, 
the horizontal lines of parameters and variables are numbered so that they 
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can be easily followed from one row to the next. Only numbered lines that 
are required to make syntax clear are in subsequent expansion rows (like 
row 2 in the third expansion continuation of the example). 


command parameter | variable parameter variable parameter variable (1) 
parameter variable parameter variable parameter (2) 


command parameter variable parameter variable 


(continued) variable parameter variable parameter 


command parameter variable parameter 
(continued) 


How defaults are indicated 

A default parameter is underlined. If, in a vertical list, an element may be 
entered, but is not required, the system must act as if some element were 
entered. The action the system takes when an element is not entered is 
called a default action and is usually an action indicated by one of the 
elements that can be selected. Occasionally, the default action is something 
other than a selectable action. These nonselectable defaults are represented 
by the word, “default,” or another word which indicates the action, and is in 
italics, to indicate that it cannot be entered. The default is fully described in 
the parameters and variables description section. 


ps_link noforce 


force wait 
unit_no nowait 


How relationships between groups of elements are indicated 
As a general rule of relationship, whenever an element is directly followed 
horizontally by another element; if the first element is selected, the second 
element is required. 


ps_link noforce 


force walt 
unit_no nowait 


Within a command expansion, elements or groups of elements (parameters 
or variables) sometimes relate to elements that precede or follow them, but 
not all the elements that precede or follow them. To distinguish which 
elements relate to which, brackets surround those elements that, as a group, 
pertain to other elements. Only those elements that horizontally directly 
precede or follow the brackets are related to the elements within the 
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brackets. When elements are not in brackets, only individual elements that 
directly precede or follow other elements are related. 


ps_link noforce 


force wait 
unit_no nowait 


How parameters and variables are described 
The parameters and variables description contains a list of every parameter 
and variable that apply to the command, in alphabetical order. Each of these 
command elements is fully described, including replacement values and 
ranges for variables. 


Following is an example of a command expansion table including the 
parameters and variables description. 


bsy command parameters and variables 


Command Parameters and variables 


ps_link noforce 
force 


unit_no 


Parameters 
and variables Description 


This parameter overrides all other commands and states in effect on the specified 
units. Ifthe whole peripheral module (PM) is to be taken out-of-service, confirma- 
tion (yes or no) is required. 


This parameter busies one of the P-side links specified by the ps_link variable. 


This default parameter indicates the condition when force parameter is not entered. 
Busy will not be forced. 


This parameter enables the MAP to be used for other command entries before the 
bsy force command action is confirmed. The nowait parameter is used only with 
the force parameter. 


This parameter causes both units of the PM to be made busy. 


This variable specifies which of the P-side links is to be busied. The range is 0-3. 


This parameter causes the PM unit specified by the unit_no variable to be made 
busy. 
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bsy command parameters and variables (continued) 


Parameters 
and variables Description 


This variable specifies which unit of the PM is to be busied. The range is 0-1. 


This default parameter indicates the default condition when no parameter is 
entered. The user must wait until the bsy force command action is confirmed befqre 
additional commands can be entered at the MAP. 


How the convention is used in command examples 


Command examples use the same convention as a command expansion, 
except that all command elements are boldface. Commands can be entered 
exactly as they appear in examples except when an example does not use an 
actual variable entry, but a variable name shown in italics. 


The following may be entered as shown. 


bsy link 2.1 


The variable ps_link must be replaced by an actual value before it can be 
entered. 


bsy link ps_link. 


How other command conventions relate to reference convention 


The command convention used in this reference document is different from 
conventions used in some older Nortel Networks documents and from 
command information at a MAP terminal. This difference is intentional. 
The convention in this document is used to simplify explanations of 
command syntax and to eliminate possible confusion. For example, when 
the command information provided in a MAP help screen is unclear, 
reference to that command represented in a different convention, such as in 
this reference manual, should eliminate the ambiguity, whereas the same or a 
similar convention would merely repeat the confusion. 
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How to compare conventions 


To take advantage of the benefits of the convention in this book, a 
comparison of the convention used in this document with the most common 
convention used in MAP help screens is provided in Table 1. 


Table 1xxx 
Command conventions comparison 


Element Commands reference manual MAP screen 


Commands lowercase or case sensitive specific: uppercase: 
bsy BSY 


Truncated shown directly below long form: Abbreviated form all uppercase, rest 
commands or a of command lowercase: 
abbreviations. Bsy 


Parameters lowercase or case sensitive specific: uppercase: 
link LINK 


Variables italic, lowercase: in angled brackets: 
<ps_link> 
note: angle brackets also indicate the 
the variable is mandatory. 


Hierarchy ght: top to bottom: 
pdte pm_numbers circuit {L <PDTC> {PDTC} 
<PM_NUMBERS> {0 TO 255} 
[<CIRCUIT> {0 to 16}] 


Defaults underlined: no specific method established, but 
wait “optional” elements (meaning they do 
nowait not have to be entered, implying 

defaults), are represented by square 
brackets: 
[<CIRCUIT> {0 to 16}] 


Selectable a vertical list: curly braces, separated by vertical 
elements link bars: 
pm {link | pm | unit} 
unit or vertical list, separated by commas: 
{link, 


pm, 
unit} 


Variable defined under parameters and curly braces: 
replacement values | variables description 10 to 16) 


297-1001-821 Standard 04.01 June 1999 


About this document xvii 


How menu command syntax is used 


In the graphic representation of the MAP menu display, all commands, 
except hidden commands are numbered. 


O0w0 JANO 


NETInteg 


Quit 
Post_ 
Mode_ 
Stelog_ 
Trnsl_ 
Rstl 


Buffsel_ 
Analyze_ 


Disp_ 
_Clear_ 
PMS_ 


_Counts_ 


_Thresh 
_Logbuff 


IOD Net PM [eel] LNS Trks Ext APPL 


Hidden commands 
FILTER 


TRLNK 
UPTH 
RETH 


Numbered commands may be entered using their associated number rather 
than the actual command. For example, the quit command is usually the 
first command in a menu, that is, number 0, and may be entered in either of 
the following ways: 


quit 
0. 


The numbered list of commands frequently contains parameters as well as 
commands. Commands and parameters can be distinguished by the 
underscores that follow commands or precede parameters as follows: 


e Tst_ a command that requires a parameter 

° CPU a parameter 

e _Card_ a parameter that requires another parameter 

e DpSync a command not requiring a parameter or variable 

e Quit a command that accepts a parameter or variable but 


does not require one 


Parameters appearing in the numbered list of commands may also be entered 
using their associated number rather than the actual parameter. A parameter 
cannot be entered by number unless the command has also been entered by 
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number. It is not necessary to enter the parameter by number even if the 
command is entered by number. 


One very important difference in the way commands and parameters are 
entered using their number rather than the actual commands and parameters 
is that no space is allowed between numbers but one is required between 
actual commands and parameters. 


For an example of the proper syntax for entering commands using or not 
using numbers, assume that Tst _ is number 6 and that _Card_ is number 
10 in the numbered list, then any of the following represents a valid entry 
for testing card 5 in unit 2: 


e 6105 2.) 

e 6card 5 2.1 

e 6 card 5 2. 
e tst card 5 2. 


What precautionary messages mean 


Danger, warning, and caution messages in this document indicate potential 
risks. These messages and their meanings are listed in the following chart. 


Message Significance 


DANGER Possibility of personal injury 
WARNING Possibility of equipment damage 
CAUTION Possibility of service interruption or degradation 


Examples of the precautionary messages follow. 


DANGER 

Risk of electrocution 

The inverter contains high voltage lines. Do not open the front 
panel of the inverter unless fuses Fl, F2, and F3 have been 


removed first. Until these fuses are removed, the high voltage 
lines inside the inverter are active, and you risk being 
electrocuted. 
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WARNING 

Damage to backplane connector pins 

Use light thumb pressure to align the card with the connectors. 
Next, use the levers to seat the card into the connectors. Failure 
to align the card first may result in bending of the backplane 
connector pins. 


CAUTION 

Loss of service 

Subscriber service will be lost if you accidentally remove a card 
from the active unit of the peripheral module (PM). Before 
continuing, confirm that you are removing the card from the 
inactive unit of the PM. 
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Commands reference tables 


To assist the user in locating a command description, two commands 
reference tables are provided in this chapter, the menu description table and 
the menu cross reference table. 


In addition to the tables, a menu chart is provided. The menu chart provides 
a quick overview of the entire menu structure. The relationships between 
menus and and sub-menus, sometimes called systems and sub-systems, are 
illustrated by means of this chart. 


Menu descriptions 


The menu description table provides a brief description of every menu 
documented in this manual. 


Menu description table 


Menu 


ACTIVITY 


ALT 


ALTBAL 


ALTCKTST 
ALTDIAG 


ALTLIT 
ALTSDIAG 


Description 
Use to provide an on-screen display of minute-by-minute 
indications of the performance status of the switch. 


Use to perform automatic line testing (ALT) tests on 
subscriber lines without manual intervention by maintenance 
personnel. 


Use to perform on-hook balance network tests (BAL) on the 
ALT. 


Use to perform keyset line circuit tests (CKTST) on the ALT. 


Use to perform the extended diagnostic test (DIAG) on the 
ALT. 


Use to perform line insulation tests (LIT) on the ALT. 


Use to perform the short diagnostic tests (SDIAG) on the 
ALT. 
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Menu description table (continued) 


Menu 


AOSSSEL 


APUX 


ATT 
AUTOCTRL 


BERP 


BERT 


CARD 


CARD 


CARRIER 


CCIS6 


ccs 


CCS7 


CHAIN 


CLOCK 
CLOCK 


Description 


Use to analyze calls that originate on Auxiliary Operator 
Services System (AOSS), Traffic Operator Position System 
(TOPS), Super Centralized Automatic Message Accounting 
(SCAMA), or Intertoll (IT) incoming trunks and require AOSS 
operator assistance. 


Use to perform maintenance for an application processing 
unit with UNIX (APUX). 


Use to monitor and control automatic trunk testing (ATT). 


Use to list, apply, remove, disable, or enable automatic 
network management (NWM) controls. 


Use to set up bit error rate performance (BERP) tests and to 
perform bit error rate tests (BERT). 


Use to measure the overall performance of the hardware 
components which form the enhanced network (ENET) 
switching matrix by querying information, defining 
parameters, and performing functions for a BERT. 


Use to query information and perform maintenance actions 
on cards. 


Use to maintain the enhanced network (ENET) on a card 
basis arranged by slot. 


Use to monitor and maintain the trunks that are associated 
with carriers. 


Use to monitor and maintain the Common Channel 
Interoffice Signaling No. 6 (CCIS6) subsystem. 


Use to monitor and maintain the Common Channel Signaling 
(CCS) system and access the CCS subsystem displays. 


Use to test and maintain Common Channel Signaling No. 7 
(CCS7) trunks. 


Use to perform maintenance actions and display status 
information on the cards of the specified chain. 


Use to test and maintain the message controller clock. 


Use to control the message switch (MS) clocks and 
synchronize them to a clock source extracted from incoming 
digital trunks, an external direct clock source, or internal 
clock. 


Use to access commands that control and display the status 
of the paired central processing units (CPU) that comprise 
the computing module (CM). 
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Menu description table (continued) 


Menu 


CODECTRL 


CONS 


CPSTATUS 


C6TTP 
C7BERT 


C7LKSET 


C7MSUVER 


C7RTESET 


C7TTP 
DCAP 


DCH 


DCTLTP 


DCTTTP 


DDU 


Description 


Use to query specific information about the performance and 
the available memory of the computing module (CM) and to 

control the load image and CM maintenance (CMMnt) level 

alarms. 


Use to list, apply, or remove code controls on specified code 
types. 


Use to access commands that test or change the status of a 
device controller (DC) and the console connected to it. 


Use to access the CPSTATUS tool to measure all CPU 
occupancies, measure of additional CPU time available for 
call processing work, and to indicate overload and switch 
performance with respect to the switch's engineering 


Use to monitor and maintain CCIS6 trunks. 


Use to evaluate the performance of a CCS7 signaling link 
before putting it into service or during fault isolation activities. 
A C7BERT test repeatedly transmits a 2047-bit 
pseudorandom pattern and subsequently checks the pattern 
to verify that no bit errors have occurred. 


Use to query and change the status of the links within a 
selected linkset. 


Use to build message signaling units (MSUs), subject them 
to the screening rules of the CCS7 link interface unit 7 
(LIU7), and display the results of screening rules that were 
encountered. 


Use to display information about or change the state of a 
routeset. 


Use to test and maintain CCS7 trunks. 


Use to obtain status information for applications and links on 
the data communications applications (DCAP). 


Use to interact with the D-channel handler (DCH) 
maintenance subsystem. 


Use to access the data call tester (DCT) menu commands 
from the LTP level. 


Use to access the data call tester (DCT) menu commands 
from the TTP level. 


Use to test and change the status of the disk drive units 
(DDU). 
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Menu description table (continued) 


Menu 


DEVICES (CFI) 


DELAYS (LGC) 
DELAYS (RCC) 
DEVICES (FP) 


DEVICES (LMX) 


DEVICES (NIU) 


DEVICES (PSP) 


DIRP 


DISPLAY 


DLC 


DPNSS 


Description 

Use to obtain information about and perform maintenance 
functions on a channel frame interface (CFI). 

Use to obtain information on call processing delays. 

Use to obtain information on call processing delays. 


Use to display status indicators of the file processor (FP) and 
to execute commands which produce these displays. 


Use to obtain information about and perform maintenance 
functions on a channel frame interface (LMX). 


Use to display information about link interface unit (LIU) 
components connected to the network interface unit (NIU). 


Use to obtain information about and perform maintenance 
functions on a programmable signal processor (PSP). 


Use to access the commands used to control the files and 
recording volumes of the device independent recording 
package (DIRP). 


Use to monitor, maintain, and display information about the 
trunks that are associated with carriers. 


Use to test and change the status of the data link controller 
(DLC). 


Use to enter the Digital Private Network Signaling System 
(DPNSS) system and query and change the status of the 
links within a selected linkset. 


Use to access and perform maintenance on a DRAM 
module. 


Use to perform control and review functions for a distributed 
recording manager (DRM). 


Use to perform maintenance functions for a digital trunk 
controller (DTC). 


Use to maintain an digital trunk controller integrated digital 
network services (ISDN) (DTCl). 


Use to access all other levels of the ENET system. The 
ENET level expands the top level alarm and allows the 
craftsperson to decide where to go next in order to correct a 
fault. 


Use to access and perform maintenance functions for an 
external node (EXND). 
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Menu description table (continued) 


Menu 


FP 
FRIU 


GRPCTRL 


IBNCON 


ICRM 


IDT 


INTCCTRL 


INTEG 


IOC 


IOD 


IPML 
IRLINK 


Description 


Use to perform maintenance on a frame transport bus 
(FBUS). 


Use to monitor and maintain the fiber multiplex terminals 
(FMT). Maintenance actions are performed on posted FMTs. 
When posting an FMT using the post command, the FMT 
sublevel is accessed, from which maintenance actions are 
conducted. 


Use to maintain and administer a file processor (FP). 


Use to perform maintenance activities on the frame relay I/F 
unit (FRIU). 


Use to list, apply, or remove group controls on selected trunk 
groups. 


Use to maintain and monitor Integrated Business Network 
(IBN) attendant consoles. 


Use to perform maintenance functions on an integrated 
cellular remote module (ICRM). 


Use to perform maintenance functions on an intelligent 
digital transmission (IDT) device. 


Use to list, apply, and remove code controls for the 
DMS-200/300 and DMS-300 switches. 


Use to analyze errors which occur along the speech links 
between the PM and the ENET. 


Use to access commands that change or monitor the status 
of disk controller (DC) cards and the devices attached to 
them. 


Use to access commands to change or monitor the status of 
the input/output devices (IOD). 


Use to access the IPML maintenance menu. 


Use to perform maintenance on the dual remote cluster 
controller (DRCC). The IRLINK level is accessed from the 
RCC level using the irlink command. Although the menu 
always shows the irlink command, it only affects a posted 
RCC that is part of a DRCC. 


Use to maintain ISDN service groups (ISG) which are 
defined for a specific LGC or LTC. In addition, hardware 
independent access to the associated channels is available. 
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1-6 Commands reference tables 


Menu description table (continued) 
Menu Description 
ISGACT Use to access the ISGACT tool to analyze the real time use 


of the signaling processor (SP), the master processor (MP), 
and the ISDN signaling processor (ISP). 


ISP Use to make measurements and report information on 
channels of the ISDN signalling processor (ISP). 


LAYER Use to check the status of selected layers and bands. 


LCM Use to perform maintenance functions on a loop 
concentrating module (LCM). 


LCME Use to monitor and maintain an enhanced line concentrating 
module (LCME). 


LCMI Use to monitor and maintain an ISDN line concentrating 
module (LCMI). 


LCOM Use to perform maintenance functions for an link interface 
unit (LIU) communication (LCOM) PM type. 


LGC Use to perform maintenance functions for a line group 
controller (LGC) 


LGCI Use to maintain an LGC equipped to provide integrated 
services digital network (ISDN) services. 


LIM Use to perform maintenance functions on a link interface 
module (LIM). 


LINESEL Use to select the classification of lines to be presented for 
service analysis (SA). 


LINKSET Use to query and change the status of a selected linkset. 


LIU7 Use to perform maintenance activities on the link interface 
unit 7 (LIU7). 


LNS Use to access subscriber line tests and associated 
maintenance actions through the LNS subsystems. 


LNSTRBL Use to maintain lines that are experiencing call processing 
trouble. 


LTC Use to perform maintenance functions for a line trunk 
controller (LTC). 


LTP Use to perform manual tests on the subscriber lines. 


LTPDATA Use to maintain control position data, posted set information, 
system status updates, and perform additional maintenance 
action on the line in the control position. 


LTPISDN Use to monitor and maintain Integrated Services Digital 
Network (ISDN) lines. 
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Menu description table (continued) 


Menu 


LTPLTA 


LTPMAN 


MANUAL 
MATRIX 


MC 
MEMORY 
MONITOR 


MP 


MTD 


MTM 


NET 


NETINTEG 


NETJCTRS 


Description 
Use to enter the line test position test access commands 
level. 


Use to enter the line test position of the manual test 
commands level. 


Use to monitor and maintain trunks. 


Use to access maintenance and diagnostic facilities for the 
switching matrix of the 128K ENET. 


Use to test and control the message controllers (MC). 
Use to manipulate the contents of the memory cards. 


Use to monitor call processing busy connections: listening, 
talking, or both. 


Use to perform maintenance on multipurpose positions 
(MPs) on TOPS position controllers (TPC) which subtend a 
TOPS Message Switch (TMS). The MP MAP level is 
accessed from the TPC level of the MAP. 


Use to access the commands that test and query the card 
and link status of a specific multi-protocol controller (MPC). 


Use to access commands to query information and perform 
maintenance procedures on the MS and MS shelves. 


Use to maintain the message switch and buffer (MSB) 
handling Common Channel Interoffice Signaling No. 6 
(CCIS6) and the CCITT No. 6 Signaling (CCITT6). 


Use to maintain the message switch and buffer (MSB) 
handling Common Channel Interoffice Signaling No. 7 
(CCIS7) and the CCITT Signaling System No. 7 (CCITT7). 


Use to test or change the status of specified magnetic tape 
drives (MTD). 


Use to perform maintenance for a maintenance trunk module 
(MTM). 

Use to perform network maintenance and to access other 
network maintenance MAP levels. 


Use to access the analysis feature which identifies errors on 
speech links between PMs and the Network. 


Use to display the status of the junctors in both planes of the 
specified network and perform maintenance functions for 
junctors. 
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Menu description table (continued) 


Menu Description 


NETLINKS Use to display the status of the links in both planes of the 
specified network and perform maintenance functions for 
links. 


NETPATH Use to test faulty paths, store test information for each path 
tested, and display this information. 


NETXPTS Use to access and perform maintenance functions on the 
crosspoint (XPT) cards in both planes of a network module 
(NM). 


Use to perform maintenance activities on the network 
interface unit (NIU). 


Use to monitor and maintain communications between a 
DMS and a network operations system (NOS). 


Use to access network management (NWM) control levels, 
to display the status of automatic and manual controls, and 
to change the switch operating mode. 


OAU Use to perform maintenance functions for an office alarm 
unit (OAU). 


OFCINTEG Use to access the bit error rate performance (BERP) and 
wideband error rate test (WBERT) sublevels. 


OPMPES Use to remotely control battery string switching, identify the 
alarm and state conditions of the OPMPES, identify the 
shelves and bay, and give the circuit location. 


PERFORM Use to display information about the processors of a posted 
PM of node type LGC, LTC, DTC, or RCC. 


PLANE Use to maintain and administer a file processor (FP). 
PM Use to access the PM maintenance system. 


PMACT Use to access the PMACT tool which is used to analyze the 
real-time use of the signaling processor (SP), the master 
processor (MP), and the ISDN signaling processor (ISP). 


PMC Use to control the peripheral message controllers (PMC) and 
their individual ports. 


PORT Use to control individual ports of the MC. 


POST Use to monitor and maintain the trunks that are associated 
with carriers. 


POSTDEV Use to maintain and administer the posted file processor 
(FP) devices. 


PRADCH Use to maintain DTCI B-channels and D-channels. 
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Menu description table (continued) 


Menu 


RCC 
RCCI 


RTECTRL 
SA 


SAEDIT 
SASELECT 


SBS 


SBSCOMM 
SBSSEL 


SBSSTAT 
SBSTRM 
SCCPLOC 


SCCPRPC 


SCCPRSS 


SCP 


SCPLOC 


SEAS 


Description 


Use to query and change the status of the logical 
communication links between a signaling transfer point 
(STP) and the signaling engineering and administration 
system (SEAS). 


Use to maintain a remote cluster controller (RCC). 


Use to maintain the integrated services digital network 
(ISDN) RCC (RCCI). 


Use to list, apply, or remove controls on specified reroutes. 


Use to perform service analysis (SA) on selected types of 
calls. 


Use to edit service analysis (SA). 


Use to select the classification of calls to be presented for 
service analysis (SA). Also use the commands available 

from the the SASelect level to control the monitor and the 
traffic offices included in analysis. 


Use to activate, deactivate or set backup for the billing 
server. 


Use to access the SBS level. 


Use to perform S/DMS (or Formatter/Storage Agent [FSA]) 
(SBS) reporting and controling functions. 


Use to display information about billing server data streams. 
Use to display information about billing server streams. 


Use to query or change the state of one or more signaling 
connection control part (SCCP) local subsystems. 


Use to query or change the state of a signaling connection 
control part (SCCP) remote point code. 


Use to query or change the state of one or more signaling 
connection control part (SCCP) remote subsystems. 


Use to post SCP services, display alarm information about 
SCP alarms, list datafilled SCP services, and access the 
SCPLoc level. 


Use to diagnose system faults and to carry out maintenance 
operations and corrective actions. 


Use to query, test, and change the operating state of the 
signaling engineering and administration system (SEAS). 
This level also has access to the PVC (permanent virtual 
circuits) level of maintenance. 
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Menu description table (continued) 


Menu 


SHELF 


SLM 
SMS 


SMU 


SPM 


SRUPES 


STAT TKGRP 


STAT TRKS 
STC 


SYSTEM 


TMS 


TPC 


TRKCONV 
TRKS 
TRKSTRBL 


TSTEQUIP 


Description 


Use to maintain the enhanced network (ENET) as a 
collection of cards and to perform maintenance actions on 
the functions of a slot as a single entity. 


Use to access commands to query information and perform 
maintenance on the message switch (MS) shelves. 


Use to access maintenance functions for the specified SLM. 


Use to perform maintenance for a Subscriber Carrier 
Module-100S (SMS). 


Use to perform maintenance for a Subscriber Carrier 
Module-100 Urban (SMU). 


Use to perform maintenance for a service peripheral module 
(SPM). 


Use to remotely control battery string switching, identify the 
alarm and state conditions of the SRUPES, to identify the 
shelves and bay, and give the circuit location. 


Use to monitor and maintain trunk groups. 
Use to monitor and maintain individual trunks. 


Use to maintain signal terminal controllers (STC) attached to 
message switch and buffers (MSB). 


Use to maintain the enhanced network (ENET) processing 
complexes. 


Use to maintain a TOPS message switch. 


Use to access the Traffic Operator Position Controller (TPC). 
Feature package NTXA83AA is required for this level to be 
operational. 


Use to monitor and maintain trunks. 
Use to access the sublevels of trunk maintenance. 


Use to provide trunk maintenance through thresholding and 
alarm generation, and buffering of trunk trouble information. 
This level is used only for identifying troubled trunks and 
their problems. 


Use to display and post stand-alone test equipment. 


Use to monitor and maintain trunk status and access the 
trunk maintenance sublevels. 


Use to transfer data and to perform maintenance on the data 
transfer system. 
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Menu description table (continued) 


Menu Description 


XLIU Use to perform maintenance activities on the x.25/x.75 link 


I/F unit. 


X75TTP Use to monitor and maintain trunk status and access the 
trunk maintenance sublevels. 


Menu cross-reference 


The menu cross-reference table provides a complete alphabetic list of every 
command and indicates its associated menu and the number of the page in 
this manual where that command is described. 


Command/menu cross reference table 


Command 


XFER 
CARD 

CM 

DCH 

DEVICES (CFI) 
DEVICES (FP) 
DEVICES (LMX) 
DEVICES (PSP) 
DTC 

DTCI 

FP 

ICRM 

LGC 

LGCI 

LTC 

MATRIX 

MSB6 

MSB7 
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1-12 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


abtk 
abtk 
abtk 
abtk 
abtk 
abtk 
abtk 
abtk 
abtk 
abtkmcr 
abtdly 
ack 

act 

act 

act 
actfsa 
actlap 
addcos 
addcust 
adddwr 
addofc 
addsite 


adjust 


alarm 
alarm 
align 
alloc 
almstat 


alm 
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OPMPES 
RCC 
RCCI 
SHELF 
SMS 
SMU 
SRUPES 
SYSTEM 
TMS 
PLANE 
C7LKSET 
SA 
C7LKSET 
LINKSET 
SBS 
SBSSEL 
DPNSS 
LineSel 
LineSel 
LineSel 
LineSel 
LineSel 
Clock 
CMMnt 
ENET 
Memory 
DDU 

LTP 
LTPISDN 
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Command/menu cross reference table (continued) 


Command 


alt 
altinfo 
altpath 
alttest 
alttest 
alttype 
analyze 
analyze 
ans 
aosssel 
apply 
apply 
apply 
apply 


apply 
att 


aticon 
attcon 
audit 
audit 
audit 
audit 
audit 
auditlink 
autocnv 
autoctrl 
autold 
bal 

bal 


Menu 


LNS 

ALT 
NETPATH 
CARD 
NETPATH 
NETPATH 
INTEG 
NET INTEG 
SA 
SASelect 
AUTOCTRL 
CODECTRL 
GRPCTRL 
INTCCTRL 
RTECTRL 
TRKS 
LineSel 
SASelect 
DIRP 
DRM 
INTEG 
OPMPES 
SRUPES 
DPNSS 
TRKCONV 
NWM 
CMMnt 
ALT 
LTPMAN 
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1-14 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


balnet 
bchcon 
bert 
bert 
bert 
bert(isdn) 
berttime 
berttime 
bpvo 
bsy 
bsy 
bsy 
bsy 
bsy 

bsy 

bsy 
bsy 
bsy 

bsy 

bsy 
bsy 

bsy 

bsy 
bsy 

bsy 

bsy 
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Menu 


LTPLTA 
LTPISDN 
DATA 

ENET 
LTPDATA 
LTPDATA 
DATA 
LTPDATA 
LTPDATA 
APUX 

Card 

CARD 

Chain 

CONS 

C6TTP 
C7LKSET 
C7RTESET 
C7TTP 

DATA 

DCH 

DDU 

DEVICES (CFI) 
DEVICES (FP) 
DEVICES (LMX) 
DEVICES (PSP) 
DPNSS 

DRAM 

DTC 

DTCI 
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Command/menu cross reference table (continued) 


Command 


bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 


bsy 


bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy(isdn) 
bsy 
bsy 


Menu 


EIU 
ESA 
ESTU 
EXND 
FBUS 
FP 
FRIU 
IBNCON 
ICRM 
IDT 
loc 
IPML 
IRLINK 
ISG 
LAYER 
LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 
LINKSET 
LIU7 
LTC 
LTP 
LTP 
MANUAL 
MATRIX 
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1-16 Commands reference tables 


Command/menu cross reference table (continued) 


Command 
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Menu 


MC 
MONITOR 
MP 

MPC 

MS 

MSB6 
MSB7 
MTD 

MTM 

NET 

NET JCTRS 
NET LINKS 
NET XPTS 
NIU 

OAU 
OPMPES 
PLANE 
PMC 
POST 
POSTDEV 
PRADCH 
PVC 

RCCI 

RCC 
SCCPLOC 
SCCPRPC 
SCCPRSS 
SCPLOC 
SEAS 
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Command/menu cross reference table (continued) 


Command 


bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsy 
bsychn 
bsyms 
bsyms 
bterm 
buffsel 
bufpath 
busy 


busy 


callset 
calltrf 
calltrf 
cap 
card 
card 


card 


Menu 


Shelf 
SHELF 
SLM 

SMS 

SMU 
SRUPES 
STC 
SYSTEM 
TMS 

TPC 
TRKCONV 
TTP 

XLIU 
X75TTP 
Shelf 

Card 

MS 

DATA 
NET INTEG 
NETPATH 
IBNCON 
SA 

BERP 
MANUAL 
TTP 
LTPLTA 
Card 
CARD 
Chain 
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1-18 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


card 
card 
card 
card 
cardlist 
carrier 
ccbcapture 
ccis6 
ccs7 
cdr 
cdrsrch 
chain 
chain 
chain 
chain 


charge 


charge 


check 
checkinv 
chkInk 
cic 

ckt 
cktinfo 
cktinfo 
cktloc 
cktloc 
cktloc 
cktmon 


ckttst 
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Menu 


Clock 
IOC 
Shelf 
SHELF 
NETPATH 
TRKS 
INTEG 
CCS 
CCS 
IOD 

IOD 
Card 
Chain 
Clock 
Shelf 
OPMPES 
SRUPES 
BERP 
CM 

NET 
C7TTP 
TTP 
TTP 
X75TTP 
LTP 
TTP 
X75TTP 
MONITOR 
ALT 
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Command/menu cross reference table (continued) 


Command 


ckttst 
claim 


claim 


cleanup 


clear 
clear 
clear 
clear 
clear 
clear 
clkstat 
clock 
clock 
clock 
clock 
clock 
close 
clr 

clr 

clr 
clralm 
clralm 
clrouf 
clrouf 
clrbuff 
clrents 
clrents 
clrfcnt 


clrfw 


Menu 


LTPMAN 
Memory 
PLANE 
DIRP 
BERT 
C7MSUVER 
IBNCON 
INTEG 
NETPATH 
NOP 

NET 

Card 

Chain 

MC 

MS 

Shelf 
DIRP 
DRAM 
MTM 

OAU 
LNSTRBL 
TRKSTRBL 
LNSTRBL 
TRKSTRBL 
DDU 
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1-20 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


cmmnt 
cntrs 
codectrl 
coin 
coldst 
commstat 
config. 
config 
connect 
connect 
connlog 
cont 
cont 
cont 
conv 
copy 
correct 
cpos 
cpstat 
cpu 
cpypath 
create_tip 
creatset 


creatset 


cvbsy 


cvcot 
cvnext 
cvpost 


cvrts 
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Menu 


CM 
Memory 
NWM 
LTPLTA 
LTPISDN 
SBSSEL 
Memory 
PLANE 
LTPDATA 
PRADCH 
ENET 

IDT 

ISG 
PRADCH 
TRKCONV 
DRM 
SAEdit 
MONITOR 
PM 

ENET 
NETPATH 
TTP 
LNSTRBL 
TRKSTRBL 
TRKCONV 
TRKCONV 
TRKCONV 
TRKCONV 
TRKCONV 
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Command/menu cross reference table (continued) 


Command Menu 


cvtest C7TTP 
c6state C6TTP 
c7bert C7LKSET 
c7Ikset CCS7 
c7msuver CCS7 
c7rteset CCS7 

dat DRM 


data_screen LTP 


dav_screen LTP 


dch LGCI 

dch RCCI 

dch TMS 
dchcon LTPISDN 
dchcon LTPMAN 
dermoch NWM 
dcrsel NWM 
dcsig LTPISDN 
dctltp LTP 
dctttp TTP 
dddin SASelect 
ddo SASelect 
deact C7LKSET 
deact LINKSET 
deact SBS 
deactfsa SBSSEL 
deactlap DPNSS 
delays PERFORM 
demount DRM 


devices FP 
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Command/menu cross reference table (continued) 


Command Menu 


devices NIU 

define ALTBAL 
define ALTCKTTST 
define ALTDIAG 
define ALTLIT 
define ALTSDIAG 
define BERP 

define BERT 

define XFER 
defman ALTBAL 
defman ALTCKTTST 
defman ALTDIAG 
defman ALTLIT 
defman ALTSDIAG 
defpath NETPATH 
defschd ALTBAL 
defschd ALTCKTTST 
defschd ALTDIAG 
defschd ALTLIT 
defschd ALTSDIAG 
deftime BERP 
deftime DCTLTP 
deftime DCTTTP 
deftst NETPATH 
delcos LineSel 
delcust LineSel 
deldwr LineSel 
delete DCTLTP 
delete DCTTTP 
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Command/menu cross reference table (continued) 


Command 


delete_ttp 
deload 
deload 
deload 
deload 
deload 
delofc 
delman 
delsite 
det 
detail 
devices 
devtype 
dgttst 
diag 


diag 


diag(isdn) 
diagnose 
dial 

dial 
dirasst 
dirp 
disable 
disable 
disalm 
disalm 
disalm 
disalm 


disalm 


Menu 


TTP 
CARD 
ENET 
MATRIX 
SHELF 
SYSTEM 
LineSel 
ATT 
LineSel 
LTPISDN 
POST 
FP 

IOC 
LTPLTA 
ALT 

LTP 
LTP 
IBNCON 
DCTLTP 
DCTTTP 
AOSSsel 
IOD 
AUTOCTRL 
FMT 
CCIS6 
CCS7 
SCP 
SCPLOC 
STAT TKGRP 
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1-24 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


disalm STAT TRKS 
disp APUX 

disp CARD 

disp CARRIER 

disp DCH 

disp DEVICES (CFI) 
disp DEVICES (LMX) 
disp DEVICES (PSP) 
disp DISPLAY 

disp DRAM 

disp DTC 

disp DTCI 

disp EIU 

disp ENET 

disp ESA 

disp Ext 

disp ICRM 

disp IDT 

disp LCM 

disp LCME 

disp LCMI 

disp LCOM 

disp LGC 

disp LGCI 

disp LIM 

disp LIU7 

disp LNSTRBL 

disp LTC 

disp MATRIX 
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Command/menu cross reference table (continued) 


Command Menu 


MP 

MSB6 
MSB7 
MTM 

NET 

NET INTEG 
NET JCTRS 
NET LINKS 
NETPATH 
NET XPTS 
NIU 

OAU 
OPMPES 
PM 

POST 
RCC 

RCCI 
SHELF 
SMS 

SMU 

SMU 

SPM 
SRUPES 
SYSTEM 
TMS 

TPC 
TRKSTRBL 
TSTEquip 
XLIU 
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1-26 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


dispents MC 

dispcnts PMC 
dispgrp STAT TKGRP 
display BERT 
display DCTLTP 
display DCTTTP 
display INTEG 
display NWM 
display SAEdit 
dispopt POST 
disptrk STAT TKGRP 
disptrk STAT TRKS 
dmnt DIRP 

dmnt XFER 

door OPMPES 
door SRUPES 
downld MPC 

dpnss CCS 

dpp IOD 

dpsync Clock 
dpsync Clock 


dpsync CM 
dpsync CMMnt 


dpsync MC 
dpsync Memory 
dpsync PLANE 
dpsync 

dpsync 

dumpb 
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Command/menu cross reference table (continued) 


Command 


dumpb 


ebsmsg 
eiobkup 
enable 
enable 
enclock 
endcld 
endclg 
equip 
equip 
equip 
exclct 
exclast 
exclst 
exclto 
exclto 
e2alink 
fault 
fbus 
fent 
filter 
filter 
findstate 
fmt 

fris 

fris 

fris 

fris 


fris 


Menu 


SBSSTAT 
LTP 
SBSSTAT 
AUTOCTRL 
FMT 
ENET 

SA 

SA 

Ext 
LTPDATA 
PRADCH 
AOSSsel 
SASelect 
SASelect 
AOSSsel 
SASelect 
CM 

MTD 

LIM 

DDU 
INTEG 
NET INTEG 
ENET 

PM 
IBNCON 
LTP 
MONITOR 
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1-28 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


gwtrantst 
gwtrantst 
groupcmd 
grpctrl 
haltatt 
hcpygrp 
hepytrk 
hepytrk 
help 
history 
history 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hold 
hset 


hset 


297-1001-821 Standard 04.01 June 1999 


Menu 


SCCPLOC 
SCCPRSS 
C7TTP 
NWM 

ATT 

STAT TKGRP 
STAT TKGRP 
STAT TRKS 
DCAP 
OPMPES 
SRUPES 
C6TTP 
C7TTP 
DATA 
DCTLTP 
DCTTTP 
LTP 
LTPDATA 
LTPISDN 
LTPLTA 
LTPMAN 
MANUAL 
MONITOR 
PRADCH 
TRKCONV 
TTP 
X75TTP 
MANUAL 
TTP 
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Command/menu cross reference table (continued) 


Command Menu 


ibntrk SASelect 
icrmlogs ICRM 

idmtce DEVICES (CFI) 
idmtce DEVICES (LMX) 
idmtce DEVICES (PSP) 
Ifsloop C7BERT 

iloss LTPISDN 
image CMMnt 

imp LTPISDN 

inclct AOSSsel 
inclqst SASelect 

inclst SASelect 

inclto AOSSsel 

inclto SASelect 

info DRM 

info EXND 

info NETPATH 

info SPM 

inh C7LKSET 
inhibit MTD 

inject DCTLTP 

inject DCTTTP 

injerr C7BERT 


insync CM 


intectrl 

integ 

integ 

interms MS 

intmess C7MSUVER 
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Command/menu cross reference table (continued) 


Command 
ioc 
ipml 
irlink 
irlink 
isg 
isg 
isg 
isgact 
ismd 
isncp 
item 
jack 
jack 
jack 


jetrs 


jetrs 


kept 
layer 
Ico 
Ico(isdn) 
Idpmall 
level 
level 
linesel 
linetst 
link 
links 
links 


linkset 
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Menu 


IOD 

PM 

RCC 

RCCI 
LGCI 
RCCI 

TMS 
PERFORM 
DCAP 
DCAP 
STAT TKGRP 
LTPMAN 
MANUAL 
TTP 

NET 

NET JCTRS 
XFER 
CCIS6 
LTP 

LTP 

PM 

LTP 

TTP 
SASelect 
LCOM 
CARD 
NET 

NET LINKS 
CCIS6 
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Command/menu cross reference table (continued) 


Command Menu 


list AUTOCTRL 
list CODECTRL 
list Ext 

list FMT 

list GRPCTRL 
list INTCCTRL 
list RTECTRL 
listalm LNSTRBL 
listalm TRKSTRBL 
listdev CONS 
listdev DDU 

listdev DLC 

listdev IOD 

listdev MPC 
listdev MTD 
listman ATT 

listset APUX 
listset DTC 

listset DTCI 

listset EIU 

listset FRIU 

listset ICRM 
listset LCM 

listset LCOM 
listset LGC 

listset LGCI 

listset 

listset 


listset 
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1-32 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


listset MSB6 
listset MSB7 
listset NIU 
listset RCC 
listset RCCI 
listset SMS 
listset SMU 
listset TMS 
listset XLIU 

lit ALT 
litinfo ALTLIT 
Insmp LineSel 
Insmp SASelect 
Instrbl LNS 

Intst LTPLTA 
loadb OPMPES 
loadb SRUPES 
loaded Card 
loadcd Chain 
loaded Clock 
loadcd Shelf 
loaden SYSTEM 
loadenall SYSTEM 
loadfw TTP 
loadms Card 
loadms Chain 
loadms MS 
loadms Shelf 


loadnotest 
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Commands reference tables 1-33 


Command/menu cross reference table (continued) 


Command Menu 


loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadnotest 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 


loadpm 
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1-34 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loadpm 
loc 

loc 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 
locate 


logformat 


logmask 
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Menu 


MSB7 
MTM 
NIU 

OAU 
RCC 
RCCI 
SMS 
SMU 
STC 
TMS 
XLIU 
NET 
NET XPTS 
CARD 
Clock 
CM 

DLC 
ENET 
MATRIX 
MC 
Memory 
PMC 
Port 
SCCPLOC 
SHELF 
SLM 
SYSTEM 
ENET 
MC 


Commands reference tables 1-35 


Command/menu cross reference table (continued) 


Command 


logmask 
logs 
loop 
loop 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk 
loopbk(isdn) 
loss 
loss 
loss 
Istband 
Istelli 
Iststop 
Istwait 
Ita 


Itloopbk 
Itp 


Itprsrc 


Ito_aux_com 
Ito_aux_gate_com 
l1blmalm 


I1thrsh 


Menu 


PMC 
INTEG 
FRIU 
POST 
BERP 
EIU 

IDT 

ISG 
LCOM 
LIU7 
LTPDATA 
PRADCH 
X75TTP 
LTPDATA 
LTPMAN 
MANUAL 
TTP 
LAYER 
ATT 
ATT 
ATT 
LTPLTA 
LTPISDN 
LNS 
LTP 
LTP 
LTP 
LTPISDN 
LTPISDN 
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1-36 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


manual TTP 
match Memory 
match PLANE 
matejam PLANE 
matrix CARD 
matrix ENET 
matrix SHELF 
matrix SYSTEM 
mc CM 

mdn IOC 
meas OPMPES 
meas SRUPES 


memory CM 


memory ENET 
mnt DIRP 
mode NET INTEG 
monconn AOSSsel 
monconn SASelect 
monitor DRM 
monitor TTP 
monlink MONITOR 
monlta LTPLTA 
monpost MONITOR 
monrel AOSSsel 
monrel SASelect 
montalk MONITOR 
mount 

mtechk 


mtechk 
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Commands reference tables 1-37 


Command/menu cross reference table (continued) 


Command Menu 


mtcchk Memory 
mtechk MS 

mtechk SLM 

next APUX 

next Card 

next C6TTP 

next C7LKSET 
next C7RTESET 
next C7TTP 

next DATA 

next DCH 

next DCTLTP 
next DCTTTP 
next DEVICES (CFI) 
next DEVICES (FP) 
next DISPLAY 
next DPNSS 
next DRAM 

next DTC 

next DTCI 

next EIU 

next ESA 

next ESTU 

next FMT 

next FRIU 

next IBNCON 
next ICRM 

next 


next 
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Command/menu cross reference table (continued) 


Command 
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Menu 


ISG 

LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 

LIU7 
LTC 

LTP 
LTPDATA 
LTPLTA 
LTPISDN 
LTPMAN 
MANUAL 
MONITOR 
MP 
MSB6 
MSB7 
MTM 
NETPATH 
NIU 

OAU 
OPMPES 
PM 
POST 
PRADCH 
PVC 


Commands reference tables 1-39 


Command/menu cross reference table (continued) 


Command Menu 


next RCC 

next RCCI 

next SA 

next SCCPLOC 
next SCCPRSS 
next SCPLOC 
next SMS 

next SMU 

next SPM 

next SRUPES 
next STC 

next TMS 

next TPC 

next TRKCONV 
next TTP 

next XLIU 

next X75TTP 
nextcall SA 

nextcall SAEdit 
nextdev POSTDEV 
nextgrp STAT TKGRP 
nextls C7LKSET 


nextpage NOP 
nextpage SBSSTAT 
nextpage SBSSTRM 
nexttrk STAT TKGRP 
nexttrk STAT TRKS 
noise LTPMAN 
noise MANUAL 
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1-40 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


TTP 

IOD 
LTPISDN 
IOD 

APUX 

Card 

CARD 
Chain 
CONS 
C7LKSET 
C7RTESET 
DCH 

DDU 
DEVICES (CFI) 
DEVICES (FP) 
DLC 
DPNSS 
DRAM 

DTC 

DTCI 

EIU 

ESA 

ESTU 
EXND 
FBUS 
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Commands reference tables 1-41 


Command/menu cross reference table (continued) 


Command Menu 


IOC 
IPML 
ISG 
LAYER 
LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 
LINKSET 
LIU7 
LTC 
MATRIX 
MPC 
MSB6 
MSB7 
MTD 
MTM 
NET 
NET JCTRS 
NIU 
OAU 
OPMPES 
POST 
POSTDEV 
PVC 
RCC 
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1-42 Commands reference tables 
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Command/menu cross reference table (continued) 


Command 


offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 

offl 
offlchn 
oosremen 
op 

op 
openckt 
openckt 


opr 


orig 


othopr 
outasst 


output 
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Menu 


RCCI 
SCCPLOC 
SCCPRPC 
SCCPRSS 
SCPLOC 
SEAS 
Shelf 
SHELF 
SLM 

SMS 
SMU 
SPM 
SRUPES 
STC 
SYSTEM 
TMS 

TPC 
XLIU 
Shelf 
SYSTEM 
MANUAL 
TTP 
OPMPES 
SRUPES 
SA 
LTPLTA 
SA 
SASelect 
BERP 


Commands reference tables 1-43 


Command/menu cross reference table (continued) 


Command 


ovrride 
ovrride 
ovrride 
ovrride 
ovrride 
pads 
page 
page 
page 
page 
page 
page 
parmset 
patchxpm 
patchxpm 
path 
pathtest 
perform 
perform 
perform 
perform 
perform 
perform 
perform 
perform 
perform 
perform 
pes 


pfquery 


Menu 


ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
TTP 
AUTOCTRL 
CODECTRL 
GRPCTRL 
INTCCTRL 
NWM 
RTECTRL 
BERP 

DTCI 

TMS 

NET 

ENET 

DTC 

DTCI 

LGC 

LGCI 

LTC 

RCC 

RCCI 

SMS 

SMU 

TMS 

PM 
PERFORM 
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1-44 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


plane FP 

pmact PERFORM 
pmc CM 
pmloader PM 
pmloop C7BERT 
pmreset DTC 
pmreset DTCI 
pmreset FP 
pmreset LGC 
pmreset LGCI 
pmreset LIM 
pmreset LTC 
pmreset MSB6 
pmreset MSB7 
pmreset NIU 
pmreset RCC 
pmreset RCCI 


pmreset SMS 


pmreset SMU 

pmreset TMS 

pms INTEG 

pms NET INTEG 

port Card 

port MC 

post ALT 

post ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
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Commands reference tables 1-45 


Command/menu cross reference table (continued) 


Command Menu 


ALTSDIAG 
APUX 

BERT 
CARRIER 
C6TTP 
C7LKSET 
C7MSUVER 
C7RTESET 
C7TTP 

DATA 

DCH 
DCTLTP 
DCTTTP 
DEVICES (CFI) 
DEVICES (LMX) 
DEVICES (PSP) 
DISPLAY 
DPNSS 
DRAM 

DTC 

DTCI 

EIU 

ESA 

ESTU 

FMT 

FRIU 
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1-46 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


ISG 

LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 

LIM 
LINKSET 
LIU7 

LTC 

LTP 
LTPDATA 
LTPISDN 
LTPLTA 
LTPMAN 
MANUAL 
MONITOR 
MP 
MSB6 
MSB7 
MTM 
NET INTEG 
NETPATH 
NIU 

NOP 
OAU 
OPMPES 
PM 
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Commands reference tables 1-47 


Command/menu cross reference table (continued) 


Command Menu 


post POST 

post PVC 

post PRADCH 
post RCC 

post RCCI 

post SCCPLOC 
post SCCPRPC 
post SCCPRSS 
post SCP 

post SCPLOC 
post SMS 

post SMU 

post SPM 

post SRUPES 
post STC 

post TMS 

post TPC 

post TRKCONV 
post TSTEquip 
post TTP 

post XLIU 

post X75TTP 
postdev DEVICES (FP) 
post(isdn) LTP 
postisg ISGACT 
postisp ISP 

post00 DTCI 
potsdiag LTP 

pps IDT 
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1-48 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


prefix 
prev 
prevdm 
prevpage 
prevpage 
print 
print 
process 
progress 
protsw 
protsw 
prtalm 
prtalm 
prvpage 
pside 
pvc 
qband 
qconline 
qconv 
qcustgrp 
qipml 
qlayer 
qlayer 
qlayer2 


qlink 
qloop 
aliperf 
qmpc 


qmspw 
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Menu 


LTP 
DPNSS 
IBNCON 
SBSSTAT 
SBSSTRM 
SA 

SAEdit 
BERP 

IDT 
CARRIER 
POST 
STAT TKGRP 
STAT TRKS 
NOP 

MS 

SEAS 
LAYER 
IBNCON 
MPC 
IBNCON 
IPML 
LAYER 
LTPISDN 
LTPDATA 
MPC 
LTPISDN 
LTPDATA 
MPC 
SASelect 


Commands reference tables 1-49 


Command/menu cross reference table (continued) 


Command Menu 


qnode DLC 

qnode MPC 
qrydev POSTDEV 
qryfepc C7LKSET 
qrysig C6TTP 
qrysig C7TTP 
asbsylk MPC 
qseated IBNCON 
qsup LNSTRBL 
qsup TRKSTRBL 
qtst NET 

qtst NET XPTS 
query C7BERT 
query DIRP 

query FBUS 


query IOC 
query NOP 
query XFER 


queryalm CCS 

querycd Card 

querycd Chain 

querycd Shelf 

queryclk Clock 

queryclk CM 

querycm Clock 

querycm CM 

querydv DEVICES (CFI) 
querydv DEVICES (LMX) 
querydv DEVICES (PSP) 
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1-50 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


queryen 
queryen 
queryen 
queryen 
queryen 
queryflg 
queryflt 
queryflt 
queryflt 
queryflt 
queryflt 
queryfmt 
queryfp 
queryir 
queryisg 
querylap 


querylk 


querylnk 
querymcr 
queryms 
queryms 
queryms 
queryms 
queryms 
querypc 
querypes 
querypes 
querypl 
querypm 
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Menu 


CARD 
ENET 
MATRIX 
SHELF 
SYSTEM 
CM 
C7LKSET 
C7RTESET 
PVC 
SCPLOC 
SEAS 
FMT 
DEVICES (FP) 
IRLINK 
ISGACT 
DPNSS 
LCOM 
DPNSS 
PLANE 
Card 

Chain 
Clock 

MS 

Shelf 
C7RTESET 
OPMPES 
SRUPES 
PLANE 
APUX 


Commands reference tables 1-51 


Command/menu cross reference table (continued) 


Command Menu 


querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querymp 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
querypm 
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1-52 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


querypm 
querypm 
querypm 
querypm 
queryproc 
queryproc 
queryproc 
queryrex 
querysrv 
queryss 
queryss 
queryss 
querystc 
querytape 
querytrf 
querytrf 
querytty 
queryupd 
queryusr 
queryusr 
quit 

quit 

quit 

quit 

quit 

quit 

quit 

quit 


quit 
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Menu 


SMU 

SPM 

TMS 

TPC 
CONS 

IOC 

MTD 
ENET 
SCP 
SCCPLOC 
SCCPRPC 
SCCPRSS 
STC 

MTD 
C7LKSET 
SCPLOC 
CONS 
SCPLOC 
C7LKSET 
DPNSS 
ACTIVITY 
ALT 
ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
APUX 

ATT 
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Command/menu cross reference table (continued) 


Command Menu 


AUTOCTRL 
BERP 
BERT 

Card 
CARRIER 
CCIS6 
CCS 

CCS7 
Chain 
Clock 
Clock 

CM 

CMMnt 
CODECTRL 
CONS 
CPSTATUS 
C6TTP 
C7BERT 
C7LKSET 
C7MSUVER 
C7RTESET 
C7TTP 
DATA 
DCAP 

DCH 
DCTLTP 
DCTTTP 
DDU 
DELAYS (LGC) 
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1-54 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


DELAYS (RCC) 
DEVICES (CFI) 


( 

DEVICES (FP) 
( 
( 


DEVICES (LMX) 
DEVICES (NIU) 
DEVICES (PSP) 
DIRP 
DISPLAY 

DLC 

DPNSS 

DRAM 

DRM 

DTC 

DTCI 

ElU 

ESA 

ESTU 

EXND 

Ext 

FBUS 

FMT 

FP 

FRIU 
GRPCTRL 
IBNCON 

ICRM 

IDT 
INTCCTRL 
INTEG 
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Commands reference tables 1-55 


Command/menu cross reference table (continued) 


Command 


Menu 


IOC 

IOD 
IPML 
IRLINK 
ISG 
ISGACT 
ISP 
LAYER 
LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 
LINKSET 
LIU7 
LNS 
LNSTRBL 
LTC 
LTP 
LTPDATA 
LTPISDN 
LTPLTA 
LTPMAN 
MANUAL 
MATRIX 
MC 


Memory 
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1-56 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


MONITOR 
MP 

MPC 

MS 

MSB6 
MSB7 
MTD 

MTM 

NET 

NET INTEG 
NET JCTRS 
NET LINKS 
NET XPTS 
NETPATH 
NIU 

NOP 

NWM 

OAU 
PERFORM 
PLANE 
PM 
PMACT 
PMC 

Port 

POST 
POSTDEV 
PRADCH 
PVC 

RCC 
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Commands reference tables 1-57 


Command/menu cross reference table (continued) 


Command Menu 


RCCI 
RTECTRL 
SASelect 
SBSCOMM 
SBSSEL 
SBSSTAT 
SBSSTRM 
SCCPLOC 
SCCPRPC 
SCCPRSS 
SCP 
SCPLOC 
SEAS 

SBS 
SHELF 
Shelf 

SLM 

SMS 

SMU 

SPM 
SRUPES 
STAT TKGRP 
STAT TRKS 
SYSTEM 
TMS 

TPC 
TRKCONV 
TRKS 
TRKSTRBL 
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1-58 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


quit TSTEquip 
quit TTP 

quit XFER 
quit X75TTP 
rab LAYER 
rcama SASelect 
relli TRKCONV 
rdbuff NET 
readfw SLM 
recann SA 
record_dtsr 

recover 

recover 

recover 

recover 

recover 

recover PM 
recover RCC 
recover RCCI 
recover SMS 
recover SMU 
release DCTLTP 
release DCTTTP 
release IBNCON 
release NOP 
remove ALTBAL 
remove ALTCKTTST 
remove ALTDIAG 
remove ALTLIT 
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Commands reference tables 1-59 


Command/menu cross reference table (continued) 


Command Menu 


remove ALTSDIAG 
remove AUTOCTRL 
remove CODECTRL 
remove GRPCTRL 
remove INTCCTRL 
remove RTECTRL 
rename DRM 

report C7BERT 
res LTPLTA 
reset BERP 

reset DRM 

reset IOC 

reset LineSel 
reset NETPATH 
resume LNSTRBL 
resume TRKSTRBL 
reth NET INTEG 
review BERP 
revive DIRP 

rex LIM 

rextst CARD 
rextst Clock 

rextst CM 

rextst CMMnt 
rextst ENET 
rextst MATRIX 
rextst MC 


rextst Memory 


rextst 
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1-60 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


rextst Port 

rextst SHELF 
rextst SYSTEM 
ring LTPLTA 
ring SA 

rlayer LTPISDN 
rlayer2 LTPDATA 
rls C6TTP 

rls C7TTP 

rls DATA 

rls MANUAL 
rls MONITOR 
rls TTP 

rls X75TTP 
rlsconn LTPMAN 
rl1 perf LTPDATA 
rotate DIRP 
rotate DRM 
rotate MEMORY 
route Clock 
route MC 

route Port 
routecm SBSSTAT 
routeset C7TTP 

rpb LAYER 
rsetvol DIRP 

rsti NET INTEG 
rtectrl NWM 

rts APUX 
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Commands reference tables 1-61 


Command/menu cross reference table (continued) 


Command Menu 


CARD 

Card 

Chain 

Clock 

CONS 

C6TTP 
C7LKSET 
C7RTESET 
C7TTP 

DCH 

DDU 

DEVICES (CFI) 
DEVICES (FP) 
DEVICES (LMX) 
DEVICES (PSP) 
DPNSS 

DLC 

DRAM 

DTC 

DTCI 

ElU 

ESA 

ESTU 

EXND 

FBUS 

FP 

FRIU 

IBNCON 

ICRM 
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1-62 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


IDT 

IOC 
IPML 
IRLINK 
ISG 
LAYER 
LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 
LINKSET 
LIU7 
LTC 
LTP 
LTP 
MANUAL 
MATRIX 
MC 
MONITOR 
MP 
MPC 
MS 
MSB6 
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Commands reference tables 1-63 


Command/menu cross reference table (continued) 


Command Menu 


NET 

NET JCTRS 
NET LINKS 
NET XPTS 
NIU 

OAU 
OPMPES 
PLANE 
PMC 
POST 
POSTDEV 
PRADCH 
PVC 

RCC 

RCCI 
SCCPLOC 
SCCPRPC 
SCCPRSS 
SCPLOC 
SEAS 
Shelf 
SHELF 
SLM 

SMS 

SMU 

SPM 
SRUPES 
STC 
SYSTEM 
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1-64 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


SYSTEM 
rts TMS 
rts TPC 
rts TRKCONV 
rts TTP 
rts X75TTP 
rtschn Shelf 
rtsms MS 
runatt 
saedit SA 
saselect AOSSsel 
saselect LineSel 
saselect SA 
saselect SAEdit 
save C7MSUVER 
sbs SBSCOMM 
sbs SBSSEL 
sbs SBSSTAT 
sbs SBSSTRM 
sbsstat SBSSEL 
sortfsa SBSSTAT 
scanms MS 
scanms Shelf 
sccploc CCS7 


sccprpc CCS7 
sccprss SCCPRPC 
scp CCS 

scploc SCP 

screen C7MSUVER 
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Commands reference tables 1-65 


Command/menu cross reference table (continued) 


Command Menu 


scur LTPISDN 
sdiag ALT 

seas CCS7 

seize C6TTP 
seize C7TTP 
seize DATA 

seize IBNCON 
seize TTP 

seize X75TTP 
select BERP 
select DCTLTP 
select DCTTTP 
select GRPCTRL 
select IBNCON 
selgrp STAT TKGRP 
selgrp STAT TRKS 
sendmsg IBNCON 
sent XFER 

set NETPATH 
setaction POST 
setafpc C7MSUVER 
setbkup SBS 
setcdpa C7MSUVER 
setcgpa C7MSUVER 
setdest C7MSUVER 
setdpc C7MSUVER 
seth0h1 C7MSUVER 
setintg INTEG 
setlog NET INTEG 
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1-66 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


setlpbk 
setopc 
setsc 
setscmg 
setsd 
setsio 
setstop 
setstst 
sgnl 
sgnl 
shelf 
shelf 
shelf 
shelf 
shelf 
shelf 
shelf 
shelf 


showbackup 


showblock 
showchn 
sim 

snid 
sortcoll 
sortisa 
sortkey 
sortstrm 
spare 


sparing 
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Menu 


LTPMAN 
C7MSUVER 
Ext 
C7MSUVER 
Ext 
C7MSUVER 
C7BERT 
ATT 
MANUAL 
TTP 

Card 

Chain 
Clock 
ENET 
MATRIX 
MS 

Shelf 
SYSTEM 
MS 

ENET 
Shelf 

IOD 
C6TTP 
SBSSTAT 
SBSSTAT 
BERP 
SBSSTAT 
Memory 
DCH 
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Command/menu cross reference table (continued) 


Command 


specsig 
spin 
split 
start 
start 
start 
start 
start 
start 
start 
start 
start 
start 
start 


start 


startchg 


startopr 
stat 
stat 
status 
status 
status 
status 
status 
status 
status 
status 
stc 


stc 


Menu 


SA 

SLM 

PMC 
ACTIVITY 
ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
ATT 

BERP 
BERT 
C7BERT 
DDU 
NETPATH 
SA 

SA 

TRKS 
TRKSTRBL 
ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
DDU 

IOC 
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1-68 Commands reference tables 


Command/menu cross reference table (continued) 


Command 


stcload 
stcload 
stksdr 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stop 
stopdisp 
stopdisp 
stoplog 
stoplog 
stoplog 
stoplog 
stoplog 
stoplog 
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Menu 


MSB6 

MSB7 

TTP 

ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
ATT 

BERP 

BERT 
C7BERT 
DCTLTP 
DCTTTP 
DDU 

DELAYS (LGC) 
DELAYS (RCC) 
ISGACT 

ISP 

NETPATH 
PMACT 
LNSTRBL 
TRKSTRBL 
ACTIVITY 
DELAYS (LGC) 
DELAYS (RCC) 
ISGACT 

ISP 

PMACT 
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Command/menu cross reference table (continued) 


Command Menu 


strmstat SBSSEL 

strt DELAYS (LGC) 
strt DELAYS (RCC) 
strt ISGACT 

strt ISP 

strt PMACT 

strtlog ACTIVITY 
strtlog DELAYS (LGC) 
strtlog DELAYS (RCC) 
strtlog ISGACT 

strtlog ISP 

strtlog PMACT 

submit ALTBAL 
submit ALTCKTTST 
submit ALTDIAG 
submit ALTLIT 

submit ALTSDIAG 


summary BERP 
suppress LNSTRBL 
suppress TRKSTRBL 
sustate LTPDATA 
sustate LTPISDN 
sustate LTPMAN 
sustate (isdn) LTPDATA 


swact Clock 

swact CM 

swact CMMnt 

swact DEVICES (CFI) 
swact DEVICES (LMX) 
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1-70 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


swact DEVICES (PSP) 
swact DTC 

swact DTCI 

swact ICRM 

swact LGC 

swact LGCI 

swact LTC 

swact MC 


swact Memory 


swact MSB6 
swact MSB7 
swact NIU 
swact PLANE 
swact PMC 
swact Port 
swact PRADCH 
swact RCC 
swact RCCI 
swact SMS 
swact SMU 
swact TMS 
swcarr Clock 
swen DEVICES (FP) 
swmast Clock 
swmast MS 

swrg LCM 
swrg 

swrg 


swtch 
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Commands reference tables 1-71 


Command/menu cross reference table (continued) 


Command 


sync 
sync 
sync 
sync 
sync 
sync 
sync 
sync 
system 
system 
system 
system 
system 
talklta 
tcopy 
tdet 

tdet 

tei 

test 
testbook 
testbook 
testreq 
testss 
tgen 
tgen 

thr 
thresh 
threshold 


time 


Menu 


Clock 
CM 
CMMnt 
MC 
Memory 
PLANE 
PMC 
Port 
CARD 
ENET 
MATRIX 
SHELF 
SYSTEM 
LTPLTA 
DRM 
MANUAL 
TTP 
LTPISDN 
LTPISDN 
DCTLTP 
DCTTTP 
ATT 
SCCPLOC 
MANUAL 
TTP 
LTPISDN 
INTEG 
MTD 

SA 
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1-72 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


timer NET INTEG 


tnsmp SASelect 


tonegen LTPMAN 
tonegen (isdn) LTPMAN 

trans FMT 

trantst SCCPLOC 
trantst SCCPRPC 
trantst SCCPRSS 
trkary C6TTP 

trkary C7TTP 

trkstrbl TRKS 

trkstrbl STAT TKGRP 
trink NET INTEG 
trnsl Card 

trnsl CARD 

trnsl Chain 

trnsl DCH 

trnsl DEVICES (CFI) 
trnsl DEVICES (LMX) 
trnsl DEVICES (NIU) 
trnsl DEVICES (PSP) 
trnsl DRAM 

trnsl DTC 

trnsl DTCI 

trnsl ESA 

trnsl FBUS 

trnsl ICRM 

trnsl IDT 

trnsl IOC 
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Command/menu cross reference table (continued) 


Command Menu 


IOD 

IPML 
IRLINK 
LCM 

LCME 
LCMI 

LGC 

LGCI 

LIM 

LTC 
MATRIX 
MC 
Memory 
MP 

MSB6 
MSB7 

MTM 

NET 

NET INTEG 
NET JCTRS 
NET LINKS 
OAU 
PLANE 
PMC 

Port 

RCC 
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Command/menu cross reference table (continued) 


Command 


trnsl 
trnsl 
trnsl 
trnsl 
trnsl 
trnsl 
trnsl 
trnsivf 
try 
try 
try 
try 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 
tst 


Standard 04.01 June 1999 


Menu 


SLM 

SMS 

SMU 

STC 

SYSTEM 

TMS 

TPC 

TTP 

CARD 

MATRIX 
SHELF 
SYSTEM 
APUX 

Card 

CARD 

Chain 

Clock 

Clock 

CM 

CONS 

C6TTP 
C7LKSET 
C7TTP 

DCH 

DDU 

DEVICES (CFI) 
DEVICES (FP) 
DEVICES (LMX) 
DEVICES (PSP) 


Commands reference tables 1-75 


Command/menu cross reference table (continued) 


Command Menu 


DLC 
DRAM 
DTC 
DTCI 
EIU 
ESA 
ESTU 
EXND 
FBUS 
FP 
FRIU 
ICRM 
loc 
IPML 
IRLINK 
LCM 
LCME 
LCMI 
LCOM 
LGC 
LGCI 
LIM 
LINKSET 
LIU7 
LTC 
MANUAL 
MATRIX 
MC 


Memory 
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1-76 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


MONITOR 
MP 

MPC 

MS 

MSB6 
MSB7 
MTD 

MTM 

NET 

NET JCTRS 
NET LINKS 
NET XPTS 
NIU 

OAU 
OPMPES 
PLANE 
PMC 

Port 
POST 
POSTDEV 
PVC 

RCC 

RCCI 
Shelf 
SHELF 
SLM 
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Commands reference tables 1-77 


Command/menu cross reference table (continued) 


Command 


tst 

tst 

tst 

tst 

tst 

tst 

tst 
tstchn 
tstdsalm 
tstdtmf 
tstms 
tstring 
tstsgnl 
tsttrnsl 
tip 

uinh 
undo 
upth 
vac 
vdc 
verpath 
view 
voice 
voice_screen 
wait 


wait 


waitfmsg 


warmswact 


warmswact 


Menu 


SRUPES 
STC 
SYSTEM 
TMS 
TPC 

TTP 
X75TTP 
Shelf 

Ext 
LTPMAN 
MS 
LTPMAN 
LTPISDN 
C6TTP 
TRKS 
C7LKSET 
TRKCONV 
NET INTEG 
LTPLTA 
LTPLTA 
NETPATH 
DRM 

SA 


FP 
LIM 
IBNCON 
DTC 
DTCI 
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1-78 Commands reference tables 


Command/menu cross reference table (continued) 


Command Menu 


warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
warmswact 
xbert 

xbert 

xfer 

xmit 
xpmlogs 
xpmlogs 
xpmlogs 


xpmlogs 


xpmlogs 


xpmlogs 
xpmlogs 
xpmlogs 
xpmlogs 
xpmlogs 
xpmlogs 
xpmlogs 
xpmreload 


xpmreload 
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Commands reference tables 1-79 


Command/menu cross reference table (continued) 


Command 


xpmreload 


xpmreload 


xpmreload 
xpmreload 
xpmreload 
xpmreload 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpmreset 
xpts 

xpts 

zoom 


zoom 


Menu 


LGCI 
LTC 
RCC 
RCCI 
SMS 
SMU 
DTC 
LGC 
LGCI 
LTC 
MSB6 
MSB7 
RCC 
RCCI 
SMS 
SMU 
NET 
NET XPTS 
ENET 
MATRIX 
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1-80 Commands reference tables 


Menu chart 
The menu chart illustrates the hierarchical relationship between menu levels 
and sublevels. In many cases the relationship between levels and sublevels 
is indicative of the command string required to reach that level, such as the 
following: 
mapci;mtc;pm.| 
which is used to reach the PM MAP level. This is not always the case, 
however, and should not be assumed. Sublevels of the PM level, for 
example, require a PM to be posted before subsequent levels can be 
accessed. 
1 2 3 4 5 6 
MAPCI NWM AUTOCTRL 
CODECTRL 
GRPCTRL 
INTLCCRTL 
RTECTRL 
SASELECT AOSSSEL 
LINESEL 
SA SAEDIT 
(MTC) (APPL) DCAP 
BERP 
ccs CCIS6 LAYER 
LINKSET 
CCS7 C7RTESET 
C7LKSET C7BERT 
SCCRPRPC SCCPRSS 
SCCPLOC 
SEAS PVC 
C7MSUVER 
SCP SCPLOC 
DPNSS 
-continued- 
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1 2 3 4 5 6 
MAPCI MTC CM CMMNT 
MC CLOCK 
PORT 
MEMORY 
PMC 
CPSTATUS 
ENET BERT 
INTEG 
SYSTEM 
MATRIX 
SHELF CARD 
EXT EQUIP DCME 
ECHOCAN 
IOD DIRP 
DPP 
IOC CONS 
DDU 
DLC 
DPAC 
MPC 
MTD 
NOP 
SLM 
XFER 
(LNS) ALT ALTBAL 
ALTCKTTST 
ALTDIAG 
ALTLIT 
ALTSDIAG 
LNSTRBL 


-continued- 
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1-82 Commands reference tables 


1 2 3 4 5 6 
MAPCI MTC (LNS) LTP CSDDS 
IBNCON 
LTPDATA 
LTPISDN 
LTPLTA 
LTPMAN 
MS CLOCK 
SHELF CARD CHAIN 
(MTCNA) TSTEQUIP ESTU 
NET NETINTEG 
NETJCTRS 
NETLINKS 
NETPATH 
NETXPTS 
PM APUX 
(CFI) DEVICES 
DTCI PERFORM 
DRAM 
ElU 
ESA 
FMT 
FP PLANE 
DEVICES POSTDEV 
FRIU 
GIC 
ICRM 
IDT 
IDTC PERFORM 


Note: IDTC=ILGC, ILTC, PDTC, ADTC 


-continued- 
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Note: LCM=LCME, LCMI, KILCM 


LCME 

LCMI 

LCOM 

LCR CCH 

LGC PERFORM PMACT 


DELAYS 


Note: LGC=DTC, LTC, RCC, SMU, SMR, SMS 


LGCI PERFORM PMACTX 
ISGACT 
DCH 
ISG 


Note: LGCI=LTCI, RCCI,TMS 


LIM FBUS 
LIU7 

(LMX) DEVICES 
MSB6 STC 


Note: MSB6=MSB7 
MTM 


Note: MTM=TM8, TM2, TM4, RMM, OAU, LM, DCM, 
STM, ATM, DES, ISLM, T8A, MMA, TAN 


NIU DEVICES 


OAU 


-continued- 
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2 3 
MTC PM 
TRKS 
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4 5 
OPMPES 


PSP 


RCC PERFORM 


IRLINK 


RCCI 


RCS 


RCT 


Note: RCT=TCS 


RCU 

SRU SRUPES 
VCH 

SMU RCU 

SMSR 

SPM 

SRUPES 

TMS 

TPC MP 

XLIU 

ATT 

CARRIER POST 
DISPLAY 

STATTKGRP _STATTRKS 

TRKSTRBL 


-continued- 


PMACT 
DELAYS 


TRKS 


Commands reference tables 1-85 


TTP MANUAL 
MONITOR 
C6TTP 
DATA 
C7TTP 
PRADCH 
TRKCONV 
ECHOCTRL 
XDCME 
X75TTP 


-end- 
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D-1 


DATA level commands 
Use the DATA level of the MAP to run bit error ratio tests (BERT). 


Accessing the DATA level 
To access the DATA level, enter the following from the CI level: 
mapci;mtc;trks;ttp;data 


DATA commands 


The commands available at the DATA MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


Command 
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D-2 DATA level commands 


DATA menu 


The following figure shows the DATA menu and status display. The insert 
with the hidden command is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 

TTP 

0 Quit_ POST 127 DELO D 4 BUSYQ A 59 DIG 

2 Post_ TTP 14 

3 seize_ CKT TYPE PM NO. COM LANG STA S R DOT TE RESULT 
4 OG MF DTC 0 1 2 OTMF1 2 SZD DTU. 1 

5 Bsy_ BLKS: 12345678 

6 RTS_ ERRS: 99 HOLD1 

7 BTerm_ BER: 1.0*10E-6 HOLD2 

8 BERT_ SYNC: INSYNC HOLD3 

9 
10 TTP NUMBER is: 14 
11 Hold NO CKT, SET IS EMPTY 
12 Next_ TIP; 
13 Rls_ 
ie Hidden command 
16 Berttime 
17 
18 
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DATA level commands D-3 
bert 


Function 
Use the bert command to run the bit error ratio test (BERT). 


bert command parameters and variables 


Command Parameters and variables 


start speed bit_pattern 
stop 

inject error_bits 

reset 


query tests 
results 


Parameters 
and variables Description 


bit_pattern This variable is P511 or P0247 to specify a known pattern of the BERT. 
error_bits This variable is 0-16 to specify the bit errors. 


inject This parameter injects the bit error into the known bit_pattern so errors can be co 
pared to the expected pattern and traced through the system. 


query This parameter displays the test results for the circuit in the control position. 
reset This parameter resets BERT results. 
results This parameter displays all test results. 


speed This variable is 56 kbps or 64 kbps to specify the transmission speed of the BER 
signals. 


start This parameter starts the BERT on the circuit in the trunk test position (TTP) DATA 
control position. 


stop This parameter stops the BERT. 


tests This parameter displays the trunks on which BERT is active. 


Qualification 


Before using the bert command, use the bterm command to set up the type 
of termination that is required to run bert. 


Example 
The following table provides an example of the bert command. 
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D-4 DATA level commands 
bert (continued) 


Examples of the bert command 


Example 


Task, response, and explanation 


bert start 56 P2047 J 


initiates the BERT, 
specifies the transmission speed of the BERT signals as 56 000 bps (bits per second). 


P2047 


Task: 


specifies the bit pattern as 2047 bits. 


Initiate a BERT, with a transmission speed of 56 000 bps and a bit 


pattern of 2047 bits. 


Response: 


BLOCKS SENT 
ERRORS 

SLIPS 

BER 

ERR FREE SEC 
TIME IN SYNC 
TST DURATION 


50987 
123 
3 
2.3*10E-3 
100 MIN 
200 MIN 
240 MIN 


TERMINATION 
MODE 
SPEED 
BIT PATTERN 
START TIME 
STOP TIME 
STOP REASON 


Terminating test line 

Synchronous 

56000 BPS 

2047 bits 

1992/06/05 20:22:01.236 FRI. 
: 1992/06/05 24:22:10.123 FRI. 
: CIRCUIT TROUBLE 


Explanation: The system displays information gathered from the BERT. The 


display shows there is circuit trouble. 


Responses 
The following table provides explanations of the responses to the bert 


command. 


Responses for the bert command 


MAP output Meaning and action 


30 IPM TONE DETECTED 


Meaning: The command has been entered and a 30 IPM tone has been detected. 


Action: None 
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DATA level commands D-5 
bert (continued) 


Responses for the bert command (continued) 
MAP output Meaning and action 
120 IPM TONE DET 


Meaning: The command has been entered and a 120 IPM tone has been 
detected. 


Action: None 
800 HZ TONE DETECTED 


Meaning: The command has been entered and an 800 Hz tone has been 
detected. 


Action: None 
ANN/VOICE DETECTED 


Meaning: The command has been entered and announce/voice has been 
detected. 


Action: None 
ANSWER NOT RECEIVED 
Meaning: The command has been entered and no answer was received. 
Action: None 
AUDIO TONE DETECTED 
Meaning: The command has been entered and audio tone has been detected. 
Action: None 
BERT TEST STARTED 
Meaning: The command has been initiated. 
Action: None 


BERT TEST STOPPED 


Meaning: The command has been manually stopped. 


Action: None 
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D-6 DATA level commands 


bert (continued) 


Responses for the bert command (continued) 


MAP output Meaning 


BUSY TONE DETECTED 
Meaning 


Action: 


CALL FAILURE MSG 


Meaning: 


Action: 


CIRCUIT TROUBLE 


Meaning: 


Action: 


CONFUSION MSG RCVD 


Meaning: 


Action: 


CONN INTEGRITY FL 


Meaning: 


Action: 


DIAL TONE DETECTED 


Meaning: 


Action: 


ERRORS INJECTED 


Meaning: 


Action: 


and action 


: The command has been entered and a busy tone has been detected. 


None 


The command has been entered and a call failure message has been 
detected. 


None 


The command has been entered and circuit trouble has been detected. 


None 


The command has been entered and a confusion message has been 
detected. 


None 


The command has been entered and the integrity of the connection 
failed. 


None 


The command has been entered and dial tone has been detected. 


None 


The bit errors have been added to the pattern of bits that compromise 
the BERT signaling. 


None 
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DATA level commands D-7 
bert (continued) 


Responses for the bert command (continued) 
MAP output Meaning and action 
FAILED TO GET RESULT 
Meaning: The command has been entered but failed to get a result. 


Action: None 

FAILED TO GET SYNC 
Meaning: The command has been entered and failed to get synchronization. 
Action: None 

FAILED TO INJECT ERR 


Meaning: The error bits cannot be added to the bit pattern because there is no 
communication with the peripheral module (PM). 


Action: None 
FAILED TO RESET 


Meaning: The BERT cannot be RESET at this time because there is no 
communication with the PM. 


Action: None 

FAILED TO STOP BERT 
Meaning: The BERT cannot be stopped at this time. 
Action: None 

FAR END CONGESTION 


Meaning: The command has been entered and far end congestion has been 
detected. 


Action: None 


FLASH MSG RECEIVED 


Meaning: The command has been entered and a flash message has been 
received. 


Action: None 
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D-8 DATA level commands 
bert (continued) 


Responses for the bert command (continued) 
MAP output Meaning and action 
HIGH AND DRY TONE 


Meaning: The command has been entered and high and dry tone has been 
detected. 


Action: None 
HIGH TONE DETECTED 
Meaning: The command has been entered and high tone has been detected. 
Action: None 
HIT DETECTED 
Meaning: The command has been entered and a hit has been detected. 


Action: None 


IBERT <cc> IS TESTING <clli> <pp> 


Meaning: The BERT is active on a trunk group, where: 


<cc> isthe number of the carrier. 
<clli> is the CLLI name of the trunk group. 


<pp> is the PM port number to which the carrier is connected. 
Action: None 


INJECT FL, NO SYNC 


Meaning: The error bits cannot be added to the bit pattern because the 
connections for sending and receiving are not synchronized. When 
starting is fully initiated, the DATA status display shows INSYNC beside 
the header SYNC and an increase in the block count beside the header 
BLKS. 


Action: Wait until the status display indicates the start is fully initiated. 
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bert (continued) 


Responses for the bert command (continued) 
MAP output Meaning and action 
LOW TONE DETECTED 
Meaning: The command has been entered and low tone has been detected. 
Action: None 
TONE DETECTED 
Meaning: The command has been entered and mw tone has been detected. 
Action: None 
ACTIVE TTP TRUNK BERT TEST 
Meaning: BERT is not being run on any trunks in that office. 
Action: None 


FAR END TEST LINE 


Meaning: The command has been entered and no far end test line has been 
detected. 


Action: None 
TEST EQUIPMENT 


Meaning: The command has been entered and no test equipment has been 
detected. 


Action: None 
TONE DETECTED 
Meaning: The command has been entered and no tone has been detected. 


Action: None 


TTP TRUNK BERT TEST RESULTS 


Meaning: There are no BERT results to be displayed. 


Action: None 
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D-10 DATA level commands 
bert (continued) 


Responses for the bert command (continued) 

MAP output Meaning and action 

NTWK CONNECTION FL 
Meaning: The command has been entered but the network connection failed. 
Action: None 

OUTLS INVALID RPLY 


Meaning: The command has been entered and an invalid OUTLS reply has been 
detected. 


Action: None 


OUTPULSE CONGESTION 


Meaning: The command has been entered and outpulse congestion has been 
detected. 


Action: None 


OUTPULSE HARDWARE FL 


Meaning: The command has been entered and the outpulse to hardware has 
failed. 


Action: None 


OUTPULSE NO REPLY 


Meaning: The command has been entered and outpulse no reply has been 
detected. 


Action: None 
OUTPULSE TROUBLE 


Meaning: The command has been entered and outpulse trouble has been 
detected. 


Action: None 
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bert (continued) 


Responses for the bert command (continued) 

MAP output Meaning and action 

OVERFLOW TONE DET 
Meaning: The command has been entered and overflow has been detected. 
Action: None 

PERIODIC SIGNAL DET 


Meaning: The command has been entered and a periodic signal has been 
detected. 


Action: None 


REORDER TONE DET 


Meaning: The command has been entered and a reorder tone has been detected. 
Action: None 

RINGING TONE DET 
Meaning: The command has been entered and a ringing tone has been detected. 


Action: None 


S/W WAIT FAILED 


Meaning: The command has been entered but failed to get a result. 


Action: None 


SYNC LOST 
Meaning: The command has been entered and synchronization has been lost. 


Action: None 


TEST EQUIPMENT TBL 


Meaning: The command has been entered and test equipment trouble has been 
detected. 


Action: None 
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D-12 DATA level commands 
bert (end) 


Responses for the bert command (continued) 


MAP output Meaning and action 


TEST PROGRESS TONE 


Meaning: 


Action: 


TEST RESULTS RESET 


Meaning: 
Action: 
TL UNEXPECTED MSG 


Meaning: 


Action: 
TONE DETECTOR FL 

Meaning: 

Action: 
UNKNOWN MSG RCVD 


Meaning: 


Action: 


297-1001-821 Standard 04.01 June 1999 


The command has been entered and test progress tone has been 
detected. 


None 


The BERT results have been cleared. 


None 


The command has been entered and an unexpected transmission link 
(TL) message was detected. 


None 


The command has been entered and the tone detector has failed. 


None 


The command has been entered and an unknown message has been 
received. 


None 


DATA level commands D-13 


berttime 
Function 
Use the berttime command to specify the duration of the bit error ratio test 


(BERT). 


berttime command parameters and variables 


Command Parameters and variables 


berttime continual mins 
duration hrs 


Parameters 
and variables Description 


continual This represents a system default. Unless a duration is specified, the system will ryn 
the BERT until stopped. 


duration This variable specifies the duration time in minutes or hours, depending on the pre 
ceding parameter. 


hrs This parameter specifies that the duration is in hours. 


mins This parameter specifies that the duration is in minutes. 


query This parameter displays the total duration of the test. 


set This parameter sets the duration of the BERT. 


Qualifications 
The berttime command is qualified by the following exceptions, restrictions, 
and limitations: 


e If 0 (zero) is specified, or if no duration is specified, the test runs until 
stopped. 

e The berttime command is valid only when the termination is not a test 
line termination. 
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Example 
The following table provides an example of the berttime command. 


Example of the berttime command 


Example Task, response, and explanation 


berttime set 20 mins — 
where 


set specifies that the BERT will have a limited duration. 


20 specifies the amount of time for the BERT. 
mins specifies that the time will be counted in minutes. 


Task: Set the BERT duration to 20 minutes. 
Response: 
INFORMATION REGISTERED 


BERT TEST TIME : 20 MINS 
IT WILL BE USED ON NEXT BERT TEST REQUEST 


Explanation: The duration of the next BERT is set at 20 minutes. 


Responses 


The following table provides explanations of the responses to the berttime 
command. 


Responses for the berttime command 
MAP output Meaning and action 
INFORMATION REGISTERED 


BERT TEST TIME : nnn HRS 
IT WILL BE USED ON NEXT BERT TEST REQUEST 


Meaning: The display shows the set duration time in hours for the next BERT. 


Action: None 
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Responses for the berttime command (continued) 


MAP output Meaning and action 


INFORMATION REGISTERED 
BERT TEST TIME : nnn MINS 
IT WILL BE USED ON NEXT BERT TEST REQUEST 


Meaning: The display shows the set duration time in minutes for the next BERT. 


Action: None 
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Function 
Use the bsy command to set a circuit to the specified out-of-service state. 


bsy command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter has the same meaning as the all parameter. This parameter spec}- 
fies that all posted circuits are placed in the busy queue all (BUSYQALL) queue ta 
be busied. For circuits that were previously posted by group (the command post 
9), all circuits in the group are busied. When used after inb, mb, or sb, this parame- 
ter specifies that the posted trunk be placed in the busy queue (BUSYQ) and put 

in the specified state when call processing or maintenance action is completed on 
the trunks. 


This parameter has the same meaning as the a parameter. This parameter speci 
fies that all posted circuits be placed in the BUSYQALL queue to be busied. For 
circuits that were previously posted by group (the command post g), all circuits in 
the group are busied. When used after inb, mb, or sb, this parameter specifies the 
posted trunk be placed in the busy queue (BUSYQ) and put in the specified state 
when call processing or maintenance action is completed on the trunks. 


This parameter changes the circuit state to installation busy. 


This parameter changes the circuit state to manual busy (ManB). 


This parameter changes the circuit state to system busy (SysB). 


Qualifications 


The bsy command is qualified by the following exceptions, restrictions, and 
limitations: 


e Busying a circuit makes it unavailable for call processing. Circuits can 
be busied either manually when maintenance personnel put the circuit 
into the ManB state or automatically when the system performs the same 
action. 
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e Manual busying has priority to override any out-of-service state (cbsy, 
neq, pbsy, offl, and sysb). 

e If call processing or maintenance action is in progress on the circuit, it is 
placed in a Busy Queue (BUSYQ). This circuit queue, called a BUSYQ 
CCT, may contain up to 20 circuits at a time. When a circuit becomes 
available, it is busied and removed from the queue. 

e The specified group of circuits or the entire posted set can be busied by 
placing the circuits in BUSYQALL. As circuits become available, they 
are busied and deleted from the BUSYQALL. 

e If any circuits in the BUSYQALL do not become available within 4 
minutes of being queued, the system no longer attempts to busy them. 

e When busying transmission links in an office are equipped with 
Common Channel Signaling (CCIS6), CCITT6, and CCS7, an outage of 
the entire associated trunk group can occur. 

e The bsy command is the only command that has an effect on trunks 
involved in a wideband IT Integrated Services Digital Network user part 
(SUP). If a trunk is call processing busy (CPB) and the bsy command is 
done on a trunk in the control position, the trunk state is changed to call 
processing deloaded (CPD). Call processing deloaded is an indication to 
call processing software that a trunk is not to be set idle (IDL) when the 
call is released. The trunk state is changed from CPD to ManB and the 
trunk is no longer available for call processing. 

e Ifthe entire wideband IT ISUP trunk group is posted in the control 
position and the busy all command (bsy all) is issued, all trunks that are 
CPB are changed to CPD and set to ManB upon call disconnect. 


Examples 
The following table provides examples of the bsy command. 


Examples of the bsy command 
Example Task, response, and explanation 
bsy  inball. 


Task: Place all posted trunks in the busy queue and make them 
installation busy. 


Response: OK, POST SET IS SET IN BSYO. 


Explanation: The posted trunks have been placed in the busy queue and made 
installation busy. 
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bsy (continued) 


Examples of the bsy command (continued) 


Example Task, response, and explanation 


Task: Place all posted trunks in the ManB state. 


Response: STATE CHANGED. 


Explanation: The posted trunks have been placed in the ManB state. 


Responses 


The following table provides explanations of the responses to the bsy 
command. 
Responses for the bsy command 


MAP output Meaning and action 


A PVC is on this trunk. Use FRLS if necessary. 


Meaning: An X75 trunk has been accessed, the trunk has aPVC, and the bsy 
command has been used. You may need to use the forced release 
(FRLS) command. Forced release forces the trunk in the control 
position to the ManB state. This message appears on SuperNode only. 


Action: The user may opt to use the FRLS command if maintenance action is 
necessary and the bsy command will not execute. 


FAILED, NO CIRCUIT 


Meaning: The command failed because no circuit was posted. 


Action: None 
Failed to seize CKT 


Meaning: The command failed to seize a circuit. 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-20 DATA level commands 
bsy (end) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


OK, POST SET IS SET IN BSYO. 


Meaning: The posted trunks have been put in the BUSYQ. 


Action: None 
STATE CHANGED. 
Meaning: The posted trunks have been placed in the requested state. 


Action: None 
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Function 


Use the bterm command to register the type of termination that is to be set 
up in the far end office for the duration of the bit error rate test (BERT) and 
display the termination, or cancel (reset) the registry of the termination. The 
termination can be: 


e digits 
e a preset termination (set up prior to the test) 
e a terminating test line (dialed loopback on trunks). 


bterm command parameters and variables 


Command Parameters and variables 


digits 


Parameters 
and variables Description 


This parameter specifies that digits are terminated. 


This variable is 0-14 to specify the termination digits. 


This parameter sets up the test connection to whichever termination was preset. 


This parameter displays the registered termination. 
This parameter resets (cancels) the registered termination. 


This parameter sets up the termination to dialed loopback on trunks. 


Qualification 
The bterm command must be used before requesting a BERT. 


Examples 
Not currently available 
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bterm (end) 


Responses 


The following table provides explanations of the responses to the bterm 
command. 


Responses for the bterm command 


MAP output Meaning and action 


BERT TERMINATION : <term_type> 
IT WILL BE USED ON NEXT BERT TEST REQUEST 


Meaning: The type of termination for BERT is given, where <term_type> is one 
of the following: 


BERT TEST LINE 
DIGITS nnnnnnnnnnnnnn 
PRESET TERMINATION 
NO TERMINATION 


Action: None 
TERMINATION RESET 
Meaning: The termination is canceled. 


Action: None 
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Function 


Use the hold command to place the circuit in the control position at the first 
available hold position. 


hold command parameters and variables 


Command Parameters and variables 


There are no parameters and variables. 


Qualifications 
The hold command is qualified by the following exceptions, restrictions, and 
limitations: 


e The hold command works regardless of the trunk state and has no effect 
on a wideband IT Integrated Services Digital Network (ISUP) call. 


e Maintenance being done on a circuit in the control position can be 
temporarily suspended by manually placing the circuit into a hold 
position. While in the hold position, a circuit retains whatever state it 
had when in the control position, and cannot be affected by maintenance 
action. A total of 3 hold positions are available. 


e When returning a circuit from a hold position to the control position, the 
circuit currently in the control position (if any) must be: 


- transferred to a hold position 
- returned to the posted set 
- released from maintenance action. 


e When quitting the trunk test position (TTP) level of the MAP, circuits in 
the hold position retain their status and connections for up to two hours 
and the circuit in the control position is idled immediately. If during that 
time no further maintenance occurs at the TTP level, the circuits are 
released. 


e In the display for held circuits, the circuits are identified immediately 
below the information on the circuit occupying the control position. 
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Example 
The following table provides an example of the hold command. 


Example of the hold command 


Example Task, response, and explanation 


Task: Place the circuit in the control position at the first available hold 


position. 


Response: OK, CIRCUIT ON HOLD 
SHORT CLLI IS : CF3P 
OK, CIRCUIT POSTED 


Explanation: The circuit with the short CLLI of CF3P has been placed in the first 
available hold position. 


Responses 
The following table provides explanations of the responses to the hold 


command. 


Response for the hold command 
MAP output Meaning and action 
FAILED, HOLD POSITIONS BUSY 


Meaning: All hold positions are occupied by a circuit. No hold position is available 
for holding more circuits. 


Action: Remove circuits from one or more of the three hold positions before 
reissuing the hold command. 


FAILED, NO CIRCUIT 


Meaning: The command failed because no circuit was posted. 


Action: None 
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Response for the hold command (continued) 
MAP output Meaning and action 
OK, CKT ON HOLD 


Meaning: The circuit in the control position has been placed in the first available 
hold position. 


Action: None 


OK, CKT ON HOLD 
NO CKT, SET IS EMPTY 


Meaning: The currently posted circuit in the control position is held in the available 
hold position. There was only one circuit in the posted set and the 
posted set is now empty. 


Action: None 


OK, CKT ON HOLD 
SHORT CLLI IS: XXXXXXXX 


Meaning: The currently posted circuit in the control position is held in the available 
hold position. The next circuit in the post set is placed in the control 
position. Ifthe hold command is for D-channel with a backup 
D-channel, both the primary D-channel and the secondary D-channel 
display on the MAP. 


Action: None 
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Function 
Use the next command to place another circuit in the control position. 


next command parameters and variables 


Command Parameters and variables 


deltip 


 delq 
S l 


delttp 
s 


e 


Parameters 
and variables Description 


This represents a system default. When only the next command is entered, the sy- 
tem takes the next circuit from the deload queue (DELQ) and places it in the contre! 
position. If there are no circuits available from the DELQ, the system takes a circult 
from the posted set. 


This represents a system default. When the parameters s or e are not entered, thé 
system automatically deletes the outgoing circuit (if there is one) from the trunk tegt 
position (TTP). 


This parameter exchanges the circuits in the control and hold positions. 


This variable specifies the hold position number where the circuit is to be taken. 
The hold position number range is 1-3. 


This parameter ensures that the next circuit to go in the control position is from the 
posted set, and not from the DELQ. 


This parameter saves the circuit in the outgoing control position in the posted set. 
When only the next command is entered, the system takes the next circuit from the 
DELQ and places it in the control position. If there are no circuits available in the 
DELQ, the circuit is taken from the posted set. 


Qualifications 
The next command is qualified by the following exceptions, restrictions, and 
limitations: 


e Entering the next command without parameters takes the next circuit 
from the DELQ and places it in the control position. If there are no 
circuits available in the DELQ, the circuit is taken from the posted set. 
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e Without parameters s or e, the outgoing circuit is deleted from the TTP. 


e The next command works regardless of the trunk state and has no effect 
on a wideband IT Integrated Services Digital Network (ISUP) call. 


Example 
The following table provides an example of the next command. 


Example of the next command 


Example Task, response, and explanation 


Task: Place the next circuit in the control position. 


Response: Next 
POSTED CKT IDLED 
SHORT CLLI IS : CF3P 
OK, CKT POSTED 


Explanation: The next circuit has been placed in the control position. The name 
of the short common language location identifier (clli) is displayed. 


Response 


The following table provides explanations of the response to the next 
command. 


Response for the next command 
MAP output Meaning and action 


FAILED, HOLD POSITION IDLE 


Meaning: The command string next 1 is issued but no circuit is held in the first hold 
position. 


Action: None 


NO CKT, SET IS EMPTY 


Meaning: No circuit has been posted. 


Action: None 
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Response for the next command (continued) 


MAP output Meaning and action 


OK, CKT POSTED 
Meaning: The next circuit has been placed in the control position. 


Action: Continue entering commands against the circuit you have placed in the 
control position. 


POSTED CKT IDLED 
Meaning: The next circuit has been placed in the control position. 


Action: Continue entering commands against the circuit you have placed in the 
control position. 


POSTED CKT IDLED 
SHORT CLLI IS: XXXXXXXX 
OK, CKT POSTED 


Meaning: The next circuit in the posted set in now placed in the control position. 
The name of the short clli is displayed. 


Action: Continue entering commands against the circuit you have placed in the 
control position. 
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post 


Function 
Use the post command to post one or more circuits for maintenance. 


post command parameters and variables 


Command Parameters and variables 


state | firsttrkgrp | 
clli 


cptermerr 


d d pm d_pm_no ckt_no t slot to t_slot 


des des_no| b des_ckt to des_ckt 
r 
s 


clli ckt to ckt 
clnr 


pm pm_no pm_pos topm_pos 
tm_name tm_no to tm_no 
state 


clli ckt .... ckt 
enril 


cli m buffer 
he 
mr 
all 


member _# 
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post command parameters and variables 


Parameters 
and variables 


Description 


This variable represents a string of circuit numbers. 


This parameter, when preceded by: 
the b parameter-transfers circuits which are left in the busy queue after 
the time-out interval from the BUSY ALL queue to the posted set. 


the post command-posts all DMS-100 Family circuits of a particular state. 


This parameter specifies the entire contents of the maintenance (M) or call proces 
sing (CP) buffer. 


This parameter, when preceded by: 
the b parameter-removes all idle circuits from the posted set, and retains 
only out-of-service circuits. 


the post command-posts circuits from one of the two busy queues or the 
posted set. 


This variable posts the contents ofthe M or CP buffer. The buffer range is 0-9. 


This parameter transfers circuits from the BUSY CIRCUIT queue to the posted se 
(up to 10 circuits at a time). 


This variable represents the circuit number of the trunk group. If two circuit numbgrs 
are entered, all circuits from the first number to the second are posted. If only one 
number is entered, all circuits from that number to the end of the list are posted. 
The circuit number range is 0-9999. 


This variable represents the circuit number. lts range is 0-19. 


This variable represents the full or short common language location identifier (CLL) 
code assigned to a group of circuits or trunk group. When preceded by the com- 
mand string post a state, the trunk group specified by the CLLI is posted first. 


This variable following the g parameter represents the circuit number of the trunk 
group. If two circuit numbers are entered, all circuits from the first number to the 
second number are posted. If only one circuit number is posted, all numbers from 
that number to the end of the list are posted. If a circuit number is not entered, enter- 
ing the command post g clli posts up to the first 512 circuit in the group. The valud 

is 0-9 999. 


This variable following the t parameter represents circuit numbers or test equip- 
ment. Up to 10 circuit numbers can be entered serially. The value is 0-9999. 
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post command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter posts trunk entries in the CPTERMERR queue which are current 
out of service. 


This parameter posts digital trunks. 


This variable represents the circuit number of a digital echo suppressor DES. lts 
range is 0-63. 


This variable represents the DES number. lts range is 0-511. 


This variable specifies the type of digital peripheral module (PM): 


dca-Austrian digital carrier 

dcm-digital carrier module 

dct-digital carrier trunk 

dtc-digital trunk controller 
idtc-international digital trunk controller 
iltc-international line trunk controller 
Itc-line trunk controller 


rcc-remote cluster controller 


This variable represents the discrimination number of the digital PM. Its range is 
0-511. 


This parameter posts one or both sides of a DES. 


This parameter forces all circuits from the BUSY ALL queue to the posted set. 


frsttrkgro This represents a system default. You do not enter a value at the MAPWhen you 
enter the command string post a state, the system begins posting with the first trunk 
group. 


This parameter posts a group of circuits by its CLLI. If no circuit number is entered 
after the g command, entering the command post g clli posts up to the first 512 cir 
cuit in the group. 


This parameter specifies the highest count (HC) of the contents of the M or 


CP buffer. 
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post command parameters and variables (continued) 


Parameters 
and variables Description 


This variable represents the trunk member number (member_#). The trunk 


member number can be any circuit, master or slave, which is on the originating 
or terminating side and is involved in a wideband call. 


This parameter specifies the most recent (MR) content ofthe M or CP buffer. 


This represents a system default. You do not enter a value at the MAPf no circuit 
number is specified, entering the command string post g clli posts up to the first 512 
circuits in the group. 


This parameter posts a group of circuits in a non-digital PM. 


This variable specifies the type of non-digital PM. Examples of non-digital PM 
types are: 

mtm-maintenance trunk module 

oau-office alarm unit 

tm-trunk module 


This variable represents the PM discrimination number. lts range is 0-9999. 


This variable specifies the PM position. lts range is 0-29. 


This parameter posts circuits in the posted set separately according to their state. 
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post command parameters and variables (continued) 


Parameters 
and variables Description 


This variable represents one of the following circuit state codes: 
cfl The circuit state code carrier fail (cfl) represents a circuit which was 
removed from service because of failure of an associated outside 
facility. 
cpb The circuit state code call process busy (cpb) represents a circuit 
that is carrying traffic. 


cpd The circuit state code call process deload (cpd) represents a circuit 
that is carrying traffic and that another entity, such as maintenance 
(Mtce), has requested to be informed when call processing (CP) 
releases the circuit. 


The circuit state code deload (del) represents a circuit which was 
in the cpd state, has been released by CP, and is now available. 


The circuit state code idle (idl) represents a circuit that is in service 
and available to any process. 


The circuit state code installation busy (inb) represents an installed 
circuit that has not been tested. 


The circuit state code initialized (ini) represents a circuit in an 
intermediate state to which all previously cpb circuits are set 
following a system restart. 


The circuit state code lockout (lo) represents a circuit under 
continuous seizure from a far office without digits being received. 
The system continues scanning and sets circuit idl when seizure 
ceases. For CCS7 trunks, this state may be due to a problem with 
the message switch and buffer (MSB) or the interperipheral 
message link (IPML). 


The circuit state code manual busy (ManB) represents a circuit 
which was removed from service by a maintenance person and can 
only be returned to service by a maintenance person. 


The circuit state code not equipped (neq) represents circuit 
hardware that is not provided. 


The circuit state code network management busy (nmb) represents 
a circuit which is removed from service through automatic or manual 
network management action. 
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post command parameters and variables (continued) 


Parameters 
and variables Description 


The circuit state code peripheral module busy (pmb) represents a 
circuit that is not available to traffic because the associated PM is 
out of service. 


The circuit state code restricted idle (res) represents a two-way 
trunk that has restricted availability to traffic. For example, the 
outgoing side of the trunk is not available. 


The circuit state code remote make busy (rmb) represents a trunk 
with its incoming side removed from service, either by the far end or 
by the near end which informs the far end. 


The circuit state code system busy (sb) represents a circuit which is 
removed from service by system maintenance, which runs periodic 
tests until the circuit is either restored to service or set to mb; for 
example, a test to detect intermittent conditions. 


The circuit state code seized (szd) represents a circuit which has 
been seized for manual or system action. 


This parameter posts a trunk, service circuit, or test equipment by its CLLI. 
This variable represents the time slot number. Its range is 1-31. 


This parameter posts the trouble buffer. The trouble buffer was created in the 
TRKSTRBL level using the creatset command. 


This parameter posts a trunk module (TM), which is a non-digital PM. 
im_name This variable represents the trunk module name. 


tm_no This variable represents the trunk module number. Its range is 0-9 999. 


wb This parameter posts all trunk circuits involved in a wideband call. 


Qualifications 


The post command is qualified by the following exceptions, restrictions, and 
limitations: 


e The post command posts only trunks which belong to the user. 


e If the CLLI to be entered is short and a numerical value, enter the CLLI 
with single quotation marks (’) around it. 
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e To get the total number of trunks in the wideband (wb) call, you must 
add the master trunk in the control position to the number of trunk 
circuits in the post set. Obtain the number of trunk circuits in the post 
set by looking at the post indicator in the trunk test position (TTP) 
display. 

e The post command works regardless of the trunk state and has no effect 
on a wb IT Integrated Services Digital Network user part (ISUP) call. 

Example 
The following table provides an example of the post command. 


Example of the post command 
Example Task, response, and explanation 


post wb wbinc 3 -! 
where 


WBINC 3 is the third circuit on the incoming side of the call of a 6 circuit call 


Task: Place WBINC 1, which is the master circuit of the incoming side in 
a wideband (wb) call, in the control position. 


Response: POST 5 DELO D 4 BUSYO A 59 DIG 
TTP 14 0 5 0 2 10 
CKT TYPE PM NO. COM LANG STA SR DOT TER 
2W S7 S7 DIC 0 10 O WBINC 1 CPB WBOTG 1 
WIDEBAND 


Explanation: POST 5 indicates the remaining 5 circuits are still in the post set. 


Responses 


The following table provides an explanation of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


Circuit not involved in a wideband call. 


Meaning: The wb parameter was entered when the provided trunk circuit was not 
involved in a wb call. 


Action: None 
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post (end) 


Responses for the post command (continued) 


MAP output Meaning and action 


CPTERMERR QUEUE EMPTY 
NO MORE TRUNKS IN THE POSTED SET 


Meaning: The command string post cptermerr was entered when there were no 
trunks to be posted. 


Action: None 
Invalid trunk circuit. 


Meaning: The wb parameter was entered when the supporting trunk circuit was 
not a valid trunk. 


Action: None 
OK, CKT POSTED. 
Meaning: The circuit is posted. 
Action: None 
POSTED CKT IDLED. 
Meaning: The circuit is posted and idled. 
Action: None 
TEST ACCESS DENIED 
Meaning: The TTP does not own the CLLI of the entered trunk. 


Action: None 
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Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
The quit command works regardless of the trunk state and has no effect on a 
wideband IT ISUP call. 

Examples 


The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DATA level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DATA level has changed to the previous menu level. 
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Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DATA level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DATA level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DATA level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display ofthe DATA level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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ris 


Function 
Use the rls command to release the connection to the circuit in the control 
position. 


ris command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This represents the system default. When only the rls command is entered, the sys- 
tem retains the circuit in the control position in the same state as before the connef- 
tion. 


This parameter frees the circuit from the control position and deletes it from the 
trunk test position (TTP) level. This parameter has the same meaning as the rls 
parameter. 


This parameter frees the circuit from the control position and deletes it from the TTP 
level. This parameter has the same meaning as the r parameter. 


Qualifications 
The rls command is qualified by the following exceptions, restrictions, and 
limitations: 


e The rls command also idles associated test equipment (for example, the 
monitor function). 


e The rls command does not affect trunks in call processing busy (CPB). 
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D-44 DATA level commands 
rls (end) 


Example 
The following table provides an example of the rls command. 


Example of the rls command 


Example Task, response, and explanation 


Task: Release the connection to the circuit in the control position. 


Response: rls 
OK 


Explanation: The connection to the circuit in the control position has been 
released. 


Response 


The following table provides explanations of the response to the rls 
command. 


Response for the rls command 
MAP output Meaning and action 


FAILED, NO CIRCUIT 


Meaning: The command failed because no circuit was posted. 


Action: None 


Meaning: The connection to the circuit in the control position has been released. 


Action: None 
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seize 


Function 
Use the seize command to seize a posted trunk for maintenance action. 


seize command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter has the same meaning as the all parameter. The parameter speci 
fies that seizure is automatic as circuits become available. 


This parameter has the same meaning as the a parameter. The parameter speci- 
fies that seizure is automatic as circuits become available. 


This default name represents a system default. If only the seize command is en- 
tered, only the circuit in the control position is seized. 


This variable specifies the maximum quantity of circuits to be deloaded at one time. 
The range is 0-20. 


Qualifications 
The seize command is qualified by the following exceptions, restrictions, 
and limitations: 


e Normally, the maximum number of circuits in the deload queue (DELQ) 
is 20, but this number can be reduced by entering a value for the variable 
del_no. The maximum number is reset by the command seize, or 
whenever another set of circuits is posted. 


e The characters A-SZ on line 9 of the status display indicate an automatic 
seizure condition. When automatic seizure is in effect, use the next 
command to select the next circuit from the posted set that can be seized. 
Those circuits that cannot be seized are bypassed. 


e The seize command does not work on call processing busy (CPB) trunks. 
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D-46 DATA level commands 
seize (end) 


Example 
The following table provides an example of the seize command. 


Example of the seize command 


Example Task, response, and explanation 
seize .l 


Task: Seize the circuit in the control position. 
Response: CKT SEIZED 


Explanation: The circuit has been seized. 


Responses 


The following table provides explanations of the responses to the seize 
command. 


Responses for the seize command 


MAP output Meaning and action 


ALREADY DONE 


Meaning: The circuit has already been seized and you have tried to seize the 
circuit again. 


Action: None 


CKT SEIZED 


Meaning: The circuit has been seized. 


Action: None 
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D-47 


DCAP level commands 


Use the data communications application (DCAP) level of the MAP to 
obtain status information for applications and links on the DCAPs. 


Accessing the DCAP level 
To access the DCAP level, enter the following from the CI level: 
mapci;mtc;appl;dcap - 


DCAP commands 


The commands available at the DCAP MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DCAP commands 


Command 
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DCAP menu 
The following figure shows the DCAP menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
LINSCP 
DCAP DCAP OAMAP EIO 
0 Quit 
2 
3 
4 MPS: y OSI: Ri ISN: MINOR ISMD: 
5 
6 
7 ISNCP 
8 ISMD 
9 
10 
11 
r2 
13 
14 
15 
16 
17 
18 Help_ 
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DCAP status codes 


DCAP level commands D-49 


The following table describes the status codes for the DCAP status display. 


Status codes DCAP menu status display 


Code 
ISN 

minor 

critical 


ISMD 


minor 


critical 


MPS 
minor 
critical 


OSI 
minor 
critical 


Meaning 


minor alarm 


critical 
alarm 


minor alarm 


critical 
alarm 


minor alarm 


critical 
alarm 


minor alarm 


critical 
alarm 


Description 


There are minor service peripheral module (SPM) application alarms. 
There are major SPM application alarms. 


There are minor intelligent services node (ISN) simplified message desk 
interface (SMDI) asynchronous datalinks (ISMD) application alarms. 


There are major ISMD application alarms. 


There are minor multi-protocol controller (MPC) application alarms. 


There are major MPC application alarms. 


There are minor open system interconnection (OSI) application alarms. 
There are major OSI application alarms. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DCAP level commands D-51 
help 


Function 


Use the help command to provide descriptive text about each DCAP 
application that may post DCAP alarms. 


help command parameters and variables 
Command Parameters and variables 


appl_name 


Parameters 
and variables Description 


appl_name This variable is the name of the DCAP alarm application. Valid entries are 
isncp, ismd, mps, osi. 


Qualifications 


The help command is qualified by the following exceptions, restrictions, and 
limitations: 


e The intelligent services node (ISN) application is not included as a 
DCAP level application unless software support for external node access 
on the ISN is present. 


e The ISN simplified message desk interface (SMDI) asynchronous 
datalinks (ISMD) is not included as a DCAP level application unless 
software support for SMDI on ISN is present. 


e If any service peripheral modules (SPM) have been taken offline or are 
manually busy, they are not counted in the ISNCP alarms. 
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D-52 DCAP level commands 
help (continued) 


Example 
The following table provides an example of the help command. 


Example of the help command 


Example Task, response, and explanation 


help ismd — 
where 


ismd is the alarms for SMDI datalinks 


Task: Display the help screen for ISMD. 


Response: ISMD alarms describe the condition of SMDI 
datalinks at the Intelligent SErvice Node (ISN). 
Asynchronous SMDI datalinks are used between 
the ISN and an end office to which voice mail 
services are provided. A major alarm is 
posted for ISMD when an SMDI link is not in 
service. 


Explanation: The desired help text is displayed. 
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help (end) 


Responses 


The following table provides explanations of the responses to the help 
command. 


Responses for the help command 
MAP output Meaning and action 
ISNCP Application-Alarms indicate the condition of call-processing data 


connection from the Intelligent Services Node (ISN) to the 
ethernet-connected Service Peripheral Modules (SPMs). 


A MINOR ISNCP Application-Alarm indicates that at least 1 link 
to an SPM is unavailable. 


A CRITICAL ISNCP Application-Alarm indicates that ALL links 
to at least one SPM are unavailable. 


Meaning: The help text for ISNCP is displayed. 


Action: None 


ISMD alarms describe the condition of SMDI datalinks 
at the Intelligent SErvice Node (ISN). 

Asynchronous SMDI datalinks are used between 

the ISN and an end office to which voice mail 
services are provided. A major alarm is 

posted for ISMD when an SMDI link is not in service. 


Meaning: The help text for ISMD is displayed. 


Action: None 


MPC : Multi-Protocol Controller 
A communication medium 


Meaning: The help text for multi-protocol controller (MPC) is displayed in response 
to the help mps command string. 


Action: None 


OSI : Data Communication Recovery Manager (DACRM) cannot recover the OSI 
COMM stack. 


Meaning: The help text for open system interconnection (OSI) is displayed. 


Action: None 
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DCAP level commands D-55 
ismd 


Function 


Use the ismd command to display more detailed information on the 
intelligent services node (ISN) simplified message desk interface (SMDI) 
asynchronous datalinks (ISMD) status. 


ismd command parameters and variables 


Command Parameters and variables 


ismd There are no parameters or variables. 


Qualifications 


The ismd command is qualified by the following exceptions, restrictions and 
limitations: 


e The ISMD application is not included as a DCAP level application 
unless the software support for SMDI on ISN is present. 


e When the response to this command is displayed, the connection status 
at the time of the command is shown. The connection status is not 
automatically updated as it changes. When you need to ensure that the 
display is current, reissue the ismd command. 


e Minor and critical ISMD alarms are raised and lowered as conditions 
change, and the MAP display alarm area is updated accordingly. 


e Because of delays in posting ISMD alarms, a link may be out-of-service 
for 2-5 minutes before an alarm is posted. If the ismd command is 
issued within this time period, the true link status will be displayed 
though it may be inconsistent with the posted alarms. 


e The inscp command provides an opportunity to obtain additional 
information. When a minor or critical ISMD application alarm occurs, 
the ismd command indicates the cause of the alarm. 
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D-56 DCAP level commands 
ismd (end) 


Example 
The following table provides an example of the ismd command. 


Example of the ismd command 


Example Task, response, and explanation 


Task: Display more detailed information on the ISMD alarms. 


Response: ISN SMDI data link status information: 
MPC € Link STATUS 


DOWN 
1 2 OK 


Explanation: The system displays status information on each ISMD link. 


Response 
The following table provides an explanation of the response to the ismd 


command. 


Response for the ismd command 


MAP output Meaning and action 


ISN SMDI data link status information: 
MPC & Link STATUS 


DOWN 
OK 


Meaning: The system displays link status information on each ISMD. 


Action: None 
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isncp 


Function 


Use the isncp command to display more detailed information on raised 
service peripheral module (SPM) application alarms. 


isncp command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 


The isncp command is qualified by the following exceptions, restrictions, 
and limitations: 


e The intelligent services node (ISN) application is not included as an 
application unless the software support for external node access on the 
ISN is present. 


e When the response to this command displays, the connection status at 
the time of the command is shown. The connection status is not 
automatically updated as it changes. When you need to ensure that the 
current status of the links is displayed, reissue the command. 


e The minor and critical (SPM) alarms are raised and lowered as 
conditions change, and the MAP display alarm area is updated 
accordingly. 


e The inscp command provides an opportunity to obtain additional 
information. When a minor or critical SPM application alarm occurs, 
the inscp command indicates the cause of the alarm. 
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D-58 DCAP level commands 
isncp (end) 


Example 
The following table provides an example of the isncp command. 


Example of the isncp command 


Example Task, response, and explanation 


isncp | 


Task: Display more detailed information on the SPM alarms. 


Response: ISN Call-Processing Data Connection Status: 
Node LINK-0 LINK-1 


SPM : ; . 
SPM : [Node is ManB] 
SPM : DOWN DOWN 
SPM : A , 
SPM : DOWN UNEO 
SPM : [Node is Offl] 
SPM : y 


Explanation: The system displays status information on each SPM and each 
link. 


Response 


The following table provides an explanation of the response to the isncp 
command. 


Response for the isncp command 


MAP output Meaning and action 


ISN Call-Processing Data Connection Status: 
Node LINK-0 LINK-1 


SPM : š a 
SPM : [Node is ManB] 
SPM : DOWN DOWN 

SPM : 7 A 
SPM : DOWN UNEO 

SPM : [Node is Offl] 
SPM i 


Meaning: The system displays status information on each SPM and each link. 


Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for 
incrname are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current 
level. The range of retreat levels is 0-6. However, the system cannot accept a 
level number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DCAP level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DCAP level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DCAP level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DCAP level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DCAP level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DCAP level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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<MENU OR DIRECTORY> level commands D-63 
next (end) 


Function 
Use the next command to post the next DCH number in the posted set. 


next command parameters and variables 


Command Parameters and variables 


next There are no parameters or variables 


Qualifications 
None 


Examples 
The following table provides an example of the next command. 


Examples of the next command 


Example Task, response, and explanation 


Task: Post the next DCH in the posted set, but do not retain the 
previously posted DCH. 


Response: 5 spare cbsy LTC 1 port 19 


Explanation: The next DCH in the posted set, 5, is now posted. The 
previously posted DCH is no longer posted. 


Responses 


The following table provides an explanation of the response to the next 
command. 


Responses for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed DCH is the last in the posted set. 


Action: None 
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D-65 


DCH level commands 


Use the DCH level ofthe MAP to interact with the D-channel handler 
(DCH) maintenance subsystem. 


Accessing the DCH level 
To access the DCH level, enter the following from the CI level: 
mapci;mtc;pm;post Itc unit_no;dch — 


or 
mapci;mtc;pm;post Igc unit_no;dch .| 
or 
mapci;mtc;pm;post tms unit_no;dch J 
where 


unit_no is a two-digit number indictaing the unit to be posted. 


DCH commands 


The commands available at the DCH MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DCH commands 


Command 
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DCH commands (continued) 


Command 


post 
querypm 
quit 

ris 
sparing 
swtch 
trnsl 


tst 


DCH menu 


The following figure shows the DCH menu and status display. The insert 
with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 


SysB ManB OffL CBsy ISTb InSv 


PM 12 0 4 23 6 5 
DCH LTC 0 0 0 2 2 0 
0 Quit 
2 post_ LTC 1 INSv Links_OOS: CSide 0 , PSide 0 
3 Unito: Act INSv 
4 Unitl: Inact INSv 
5 Trnsl 
6 Tst DCH 0 0 0 0 0 2 
7 Bsy 
8 RIS DCH 
9 Offl 
10 LoadPM 
11 
12 Next 
13 
1% EN Hidden commands 
15 Disp 
16 sparing 
17 Swtch abtk 
18 
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DCH level commands D-67 
abtk 


Function 
Use the abtk command to abort all active tasks on the posted DCH. 


abtk command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Example 
The following table provides an example of the abtk command. 


Example of the abtk command 


Example Task, response, and explanation 


Task: Abort all current tasks. 


Response: None 


Explanation: All active tasks are aborted. 


Responses 


None 
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DCH level commands D-69 
bsy 


Use the bsy command to remove the posted DCHs from service by changing 
the state to manual busy (ManB). 


bsy command parameters and variables 


Command 


Parameters 
and variables 


Parameters and variables 


Description 


This parameter removes all the DCHs in the posted set from service. 


This parameter overrides the warning message and removes the posted DCH fro 
service. 


Qualifications 


Examples 


If there are two or more DCHs in the posted set, and you enter the command 
bsy (without parameter all), only the first DCH in the set is busied. The 
sequence of DCHs in the posted set is determined by their sequence in Table 
DCHINV. 


The following table provides an example of the bsy command. 


Examples of the bsy command 


Example 


Responses 


Task, response, and explanation 


Task: Busy the first DCH in the posted set. 


Response: DCH 4 Bsy Passed 


Explanation: The first DCH is DCH 4 and it has been busied. 


The following table provides explanations of the responses to the bsy 
command. 
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DCH level commands D-70 
bsy (end) 


Responses for the bsy command 


MAP output Meaning and action 


REQUEST INVALID - DCH n IS MANB 
Meaning: The specified DCH is already in the ManB state. 


Action: None 


DCH 4 Bsy Passed 


Meaning: The DCH is manual busy, where n is each DCH number in the posted 
set. 


Action: 
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DCH level commands D-71 
disp 


Function 
Use the disp command to display the mapping of ISGs to DCHs. 


disp command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Examples 
The following table provides an example of the disp command. 


Examples of the disp command 


Example Task, response, and explanation 


Task: Display the mapping of ISGs to DCHs 


Response: DCH 123 ISG 10 INSV LTC 20 PORT 1 
DCH 223 ISG 11 INSV LTC 20 PORT 3 
DCH 120 SPARE INSV LTC 20 PORT 5 


Explanation: The mapping of ISGs to DCHs is displayed. 


Responses 


The following table provides an explanation of the response to the disp 
command. 


Responses for the disp command 


MAP output Meaning and action 


NO DCH POSTED 


Meaning: No DCH is posted. 


Action: Post a DCH using the post command. 
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DCH level commands D-73 
loadpm 


Function 


Use the loadpm command to load the program files from the CC to the 
selected DCHs. 


loadpm command parameters and variables 


Command Parameters and variables 


source file_name walt selected 
nowait all 


Parameters 
and variables Description 


all This parameter simultaneously loads all of the DCHs from the CC. 


file_name This variable is the name of a valid program file. The name must be exceed eight 
characters. Valid load names are datafilled in data Table DCHINV, 


nowait This parameter allows the user to enter other commands at the MAP while the 
system is loading the specified DCHs. 


selected This default parameter, which is never entered, indicates that only selected DCHs 
are loaded when the all parameter is not entered. 


This variable loads all of the DCHs from the indicated source and has a range of 
cc. (That is, at the present time, the source variable is always “cc”.) 


This default parameter, which is never entered, indicates that when the nowait pa 
rameter is not entered, the user must wait until the load command has completed 
loading all specified DCHs before additional commands can be entered at the MAP 


Qualifications 


The loadpm command is qualified by the following exception, restrictions 

and limitations: 

e When selecting the CC as the source of the load, the file is transferred 
from the CC to the DCHs through the PM on which the DCH resides. 

e To determine the valid load name for the DCH, use the querypm 
command. 

e If the loadpm command is used without parameter nowait, other 
commands cannot be entered at the MAP until the system confirms that 
the loading is completed. 


e Make the DCHs manual busy before loading the files. 
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loadpm (continued) 


Examples 


e Specifying the DCH number as the source is not valid. If the DCH 
number is specified, the following message is displayed. 


DCH TO DCH LOADING IS NOT SUPPORTED 


The following table provides an example of the loadpm command. 


Examples of the loadpm command 


Example 


loadpm cc J 


Responses 


Task, response, and explanation 


Task: Load the posted DCH. 
Response: DCH 5 OK CHECKSUM #3F8 


Explanation: The posted DCH is loaded. 


The following table provides explanations of the responses to the loadpm 
command. 


Responses for the loadpm command 


MAP output 


Meaning and action 


DCH nnn OK CHECKSUM = #hhh 


Meaning: The DCH has been successfully loaded. 


Action: None 


LOAD FILE IS NOT IN DIRECTORY 


Meaning: The system cannot find the specified loadfile. 


Action: Determine the correct filename, and enter the command again. 
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loadpm (end) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 
DCH nnnn IS status 


Meaning: The DCH must be in the ManB state to be loaded, where status is any 
state other than ManB and n is the DCH discrimination number. 


Action: Make the posted DCH ManB using the bsy command. 


NO DCH POSTED 
Meaning: A DCH must be posted before it can be loseded. 


Action: Posta DCH using the post command. 
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DCH level commands D-77 
offl 


Function 


Use the offl command to remove the posted DCH from service by changing 
the state from ManB to offline (Offl). 


offl command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


all This parameter changes the state of all the DCHs in the posted set to offline. 


posted This default parameter which is never entered indicates that only posted DCHs arẹ 
removed from service when the all parameter is not entered. 


Qualifications 
None 


Example 
The following table provides an example of the offl command. 


Example of the offl command 


Example Task, response, and explanation 


Task: Remove the posted DCH from service. 


Response: DCH 4 OFFLINE PASSED 


Explanation: DCH is the posted DCH and is now Offl. 
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DCH level commands D-78 
offl (end) 


Responses 


The following table provides explanations of the responses to the offl 
command. 


Responses for the offl command 


MAP output Meaning and action 

DCH n OFFLINE PASSED 
Meaning: The posted DCH is now offline. 
Action: The DCH status display shows Offl. 


DCH n IS status 


Meaning: The DCH must be in the ManB state to be made offline, where status is 
any state other than ManB and n is the DCH discrimination number. 


Action: None 


NO DCH Posted 


Meaning: A DCH must be posted before it can be made offline. 


Action: Posta DCH and renter the command. 
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post 


Function 


Use the post command to select the set of DCHs to undergo maintenance 
action. The DCHs can be posted by discrimination number, state, or by 
using the parameter all. 


post command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter posts all the equipped DCHs on the posted LGC. 


This variable identifies the discrimination number of a DCH. The range is 0-255. 
Valid discrimination numbers are listed in Table DCHINV. 


This variable posts all DCHs in the specified state. The acceptable values for this 
variable include: SysB, ManB, Offl, InSv, ISTb, or CBsy. 


Qualifications 


Use the querypm command to display the valid discrimination number for a 
posted DCH. 


Examples 
The following table provides an example of the post command. 


Examples of the post command 


Example Task, response, and explanation 


post 8 J 
where 


8 is the discrimination number for the DCH to be posted. 
Task: Post DCH 8. 


Response: DCH 8 INSV LGC 5 P 19 


Explanation: The display responds by posting DCH 8, which is displayed as 
being in service on LGC 5 and resides in P-side port number 19. 
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post (end) 


Responses 


The following table provides explanations of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


DCH n IS NOT LOCATED ON LGC n 


Meaning: The DCH cannot be posted because it is not linked to the posted LGC. 


Action: None 

DCH n IS NOT EQUIPPED 
Meaning: The requested DCH is not datafilled, or does not exist. 
Action: None 


NO DCH POSTED 


Meaning: No DCHs are posted, or the DCHs that are posted are not in the 
specified state. 


Action: None 
Invalid Post Set 
Meaning: No such DCH number is recognized. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DCH level commands D-81 
querypm 


Function 


Use the querypm command to display information regarding a posted DCH 
in the office, including: the location, the DCH type, the load name, and the 
internal discrimination number. 


querypm command parameters and variables 


Command Parameters and variables 


querypm noflt 
flt 


Parameters 
and variables Description 


This parameter causes any DCH faults to be displayed. 


This default parameter, which is never entered, indicates that DCH faults will not 
be displayed because the flt parameter was not entered. 


Qualifications 
None 


Examples 
The following table provides an example of the querypm command. 


Examples of the querypm command 


Example Task, response, and explanation 
querypm a 


Task: Display information on a posted DCH. 


Response: 
SITE FLR RPOS BAY_ID SHF DESCRIPTION SLOT EQPEC 
HOST 01 C09 LTC 00 51 LGC: 000 :18 BXO1 
DCH TYPE: BXO1 LOADNAME: DCH31AL INTL INDEX: 280 


Explanation: The system responds by providing information on the posted DCH. 


Responses 


The following table provides an explanation of the response to the querypm 
command. 
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querypm (end) 
Responses for the querypm command 
MAP output Meaning and action 


NO DCH POSTED 


Meaning: A DCH must be posted. 


Action: Posta DCH using the post command. 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DCH level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DCH level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DCH level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DCH level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DCH level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DCH level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 
Use the rts command to return the posted DCH to service. Tests are run, and 
if they are successful, the DCHs are returned to service. The DCHs must be 
in the ManB state. 


rts command parameters and variables 


Command Parameters and variables 


noforce posted 
force all 


Parameters 
and variables Description 


all This parameter returns all DCHs in the posted set to service. 
force This parameter bypasses the tests and returns the posted DCHs to service. 


noforce This default parameter, which is never entered, indicates that returns the DCHs to 
service only after testing has passed when the force parameter is not entered. 


posted This default parameter, which is never entered, indicates that only posted DCHs afe 
returned to service when the all parameter is not entered. 


Qualifications 


The command string tst all tests all DCHs in the posted set at the same time; 
the rts command tests the DCHs sequentially. Therefore, use the command 
string tst all instead of the rts command. When testing is completed, use the 
command string rts force to bypass the RTS tests and return to service 
quickly. 


Examples 
The following table provides an example of the rts command. 
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rts (continued) 


Examples of the rts command 


Example Task, response, and explanation 


Task: Return the posted DCH to service. 
Response: DCH 4 Bsy Passed 


Explanation: DCH 4 is the posted DCH and is reteruned to service. 


Responses 
The following table provides explanations of the responses to the rts 


command. 


Responses for the rts command 
MAP output Meaning and action 
NO REPLY FROM PM 
Meaning: The LGC is not communicating with the DCHs. 


Action: None 


PM IS OFFLINE 
NO ACTION TAKEN 


Meaning: The LGC connected to the DCH is offline. The DCH cannot be tested 
until the LGC is returned to service. 


Action: None 


DCH n OUT-OF-SERVICE TEST INITIATED 
DCH n TST PASSED 
DCH n RTS PASSED 


Meaning: The out-of-service tests pass, the DCH returns to service, and the state 
changes to InSv. While the test is in progress, Mtce appears on the 
display of DCH status. 


Action: If the posted set consists of two or more DCHs and the parameter all is 
specified, test and RTS each DCH consecutively. 
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rts (end) 


Responses for the rts command (continued) 


MAP output Meaning and action 


REQUEST INVALID - DCH n IS status 


Meaning: The DCH must be in the ManB state to be made off-line, where status is 
any state other than ManB and n is the DCH discrimination number. 


Action: None 


DCH n - TEST FAILED FAIL MESSAGE RECEIVED FROM PM 
or 
DCH n - TEST FAILED RELOAD THE PM 
or 
DCH n - TEST FAILED 


Meaning: If an out-of-service test fails with one of the above reponses, the cause 
may be one of the following: 
a fault with the posted LGC 
a corrupted or missing software load 
a card failure 
Action: If the software load is corrupted or missing, reload the DCH using the 
loadpm command. To determine the correct load filename, use the 
query command. 


If a card has failed, check and replace the cards that are suspected of 
being faulty (see the list of cards in the standard card location display). 


NO DCH Posted 


Meaning: A DCH must be posted before it can be returned to service. 


Action: Post a DCH and enter the command again. 
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sparing 


Function 
Use the sparing command to enable and disable sparing for aDCH. 


Entering the command string sparing off all disables sparing on all DCHs 
and the posted LGC becomes ISTb. 


sparing command parameters and variables 


Command Parameters and variables 


sparing | posted l status 


all 


Parameters 
and variables Description 


This parameter enables or disables all posted DCHs simultaneously. 


This default parameter, which is never entered, indicates that only posted DCHs afe 
returned to service when the all parameter is not entered. 


This variable identifies sparing as on or off. The value “on” enables sparing; “off” 
disables sparing. 


Qualifications 
None 


Examples 
The following table provides an example of the sparing command. 


Examples of the sparing command 
Example Task, response, and explanation 
sparing - 
Task: Enable sparing on posted DCH 


Response: DCH 4: takeover enabled 


Explanation: DCH 4 is the posted DCH and sparing is enabled. 
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sparing (continued) 


Responses 


The following table provides explanations of the responses to the sparing 
command. 


Responses for the sparing command 


MAP output Meaning and action 


DCH n ENABLE TAKEOVER PASSED 


Meaning: If resources become available, the system will attempt a takeover. 
Action: None 
DCH xxx TAKEOVER FAILED 
Meaning: The request failed. 
Action: None 
DCH xxx DISABLE TAKEOVER PASSED 
Meaning: The request passed, and normal operation continues. 
Action: None 


DCH xxx DISABLE TAKEOVER FAILED 


Meaning: The request failed. 
Action: None 

NO DCH POSTED 
Meaning: A DCH must be posted. 


Action: Post a DCH using the command post. 


REQUEST INVALID - xx yy IS OUT OF SERVICE 


Meaning: The PM is not a valid state, where xx is the PM type and yy is the PM 
number. 


Action: Put the PM into service. 
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sparing (end) 


Responses for the sparing command (continued) 


MAP output Meaning and action 


REQUEST INVALID - TAKEOVER IN PROGRESS ON ONE OR MORE DCHS 


Meaning: Takeover is currently in progress. 


Action: Wait for the takeover to be completed, then enter the command again. 
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switch 


Function 
Use the swtch command to perform a manual takeover. 


swtch command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This variable identifies the discrimination number of the DCH to take over serviceg 
and has a range of 0-255. 


Qualification 


CAUTION 

When switching services from a DCH to an available 
spare, a 2-second interruption in services occurs. 
Established calls will remain active; however, no new calls 
are accepted during this time. 


Established calls will remain active; however, no new calls are accepted 
during the 2-second interruption in service that occurs when services are 
switched from a DCH to an available spare. 


Example 
The following table provides an example of the swtch command. 


Example of the swtch command 
Example Task, response, and explanation 


switch 5. 
where 


5 is the number of the DCH specified to take over. 


Task: Manual takeover DCH activity and pass activity to DCH 5. 


Response: TAKEOVER PASSED DCH 62 TO DCH 5 ISG 1 


Explanation: Takeover by DCH 5 from DCH 62 is successful. 
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switch (continued) 


Responses 


The following table provides explanations of the responses to the swtch 
command. 


Responses for the swtch command 


MAP output Meaning and action 


Takeover passed DCH 62 to DCH 5 ISG 1 


Meaning: The takeover was successful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 


Takeover failed DCH 62 to DCH 5 ISG 1 


Meaning: The takeover was unsuccessful, where: 
62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


The target DCH is made SysB. If the takeover failed because of a 
timeout, both DCHs are made SysB. 


Action: None 


REQUEST INVALID - DCH 62 HAS TAKEOVER DISABLED 


Meaning: The DCH has takeover disabled where 62 is the number of the DCH. 
The takeover must be enabled 


Action: None 


REQUEST INVALID - NO DCH POSTED 
Meaning: You must post a DCH. 
Action: Post a DCH using the command post. 
REQUEST INVALID - TAKEOVER IS IN PROGRESS ON DCH 62 


Meaning: A takeover is in progress on the specified DCH where 62 is the number 
of the DCH. 


Action: Enter the command again. 
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switch (continued) 


Responses for the swtch command (continued) 
MAP output Meaning and action 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Spare DCH has incompatible load 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


The spare DCH has a DCH-type load while the source has an 
EDCH-type load. 


Action: DCH must be loaded with EDCH-type load if takeover is to be used. 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: Could not convert DCH port number 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 
The DCH port number could not be identified or converted. 
Action: None 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: Invalid message from initiator 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 
Message from initiator is invalid or garbled. 
Action: None 
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switch (continued) 


Responses for the swtch command (continued) 


MAP output Meaning and action 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: Sourced DCH datafilled as a spare 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 

DCH 62 is a spare DCH. 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Spare DCH not specified in request 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 
No spare DCH identified in command. 
Action: None 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: Source DCH is not in valid state for takeover request 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
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switch (continued) 


Responses for the swtch command (continued) 


MAP output Meaning and action 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: Spare DCH already performing takeover 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Target DCH not a spare 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Target DCH not in valid state for takeover request 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
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swtch (continued) 


Responses for the swtch command (continued) 


MAP output Meaning and action 


DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: No spares available 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: No resource takeover block allocated for request 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 
Fail message received from PM 
Reason: DCH recovery timer has expired 
Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


The target DCH is made SysB. If the takeover failed because of a 
timeout, both DCHs are made SysB. 


Action: None 
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switch (end) 


Responses for the swtch command (continued) 
MAP output Meaning and action 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Error recovery sequence initiated 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 
5 is the number of the DCH takeover passed to 
1 is the number of the ISG 


Action: None 
DCH Takeover Failed DCH 62 to DCH 5 ISG 1 


Fail message received from PM 
Reason: Undefined failure reason xx 


Meaning: The takeover was unsuccessful, where: 


62 is the number of the DCH taken over from 

5 is the number of the DCH takeover passed to 
1 is the number of the ISG 

xx is a byte value 


Action: None 
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trnsl 
Function 


Use the trnsl command to display all services associated with each channel, 
or provides a summary of the services. 


trnsl command parameters and variables 


Command Parameters and variables 


posted 
all 


Parameters 
and variables Description 


The display lists the available services and the number of channels assigned to thé 
service. 


This parameter displays the services for all the channels on the posted DCHs. 


This default parameter, which is never entered, indicates that only posted DCHs afe 
affected by the trnsl command when the all parameter is not entered. 


This default parameter, which is never entered, indicates that a short listing of the 


services assigned to each channel is displayed when the full parameter is not en- 
tered. 


Qualifications 
If channel zero (0) is displayed, it is reserved for communication with the 
ISDN signaling preprocessor (ISP). 
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trnsl (continued) 


Examples 
The following table provides an examples of the trnsl command. 


Examples of the trnsl command 


Example Task, response, and explanation 


Task: Obtain information on a posted set which contains two DCH cards. 


Response: NIL CHANNELS 
ISP CHANNELS 
BRA CHANNELS 
BD CHANNELS 
TDC CHANNELS 
PNM CHANNELS 


Explanation: The system responds by providing information only on the DCH in 
the control position. 


trnsl full J 


Task: Obtain a short listing of the services that are on the DCH in the 
control position. 


Response: CH ] ISP 

CHANNEI BRA 
CHANNE] BRA 
CHANNEI BRA 


CH L BRA 
CH L BD 


CHANNEI BD 
CH L BD 
CH L BD 


PD ZZ CHANNELS 


Explanation: The system responds with a short list of services on the DCH in the 
control position. 
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trnsl (continued) 


Examples of the trnsl command (continued) 


Example Task, response, and explanation 
trnsl all 


Task: Obtain information on all DCHs in the posted set. 


Response: DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 
DCH 


NIL 
ISP 
BRA 
BD 

TDC 
PNM 
NIL 
ISP 
BRA 
BD 

TDC 
PNM 


CH 
CH 
CH 
CH 
CH 
CH 
CH 
CH 
CH 
CH 
CH 
CH 


LS 
LS 
LS 
LS 
LS 
LS 
LS 
LS 
LS 
LS 
LS 
LS 


N 


N 
OOW sare O 0O O e AO 


HOoooH-Ho0o0000o0 


pPpppprprrrrrrre 


RRP ds ds ds Qs ds ds ds BA 


Explanation: The system responds with information on all DCHs in the posted 
set. 


trnsi full all 


Task: Obtain information on all channels on all DCHs in the posted set. 


Response: DCH 0 ISG 4 CHANNEL ISP 
DCH 0 ISG 4 CHANNEL BRA 


DCH ISG 
DCH ISG 
DCH ISG 
DCH 


Explanation: 


Responses 


The following table provides an explanation of the response to the trnsl 
command. 
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trnsl (end) 


Responses for the trnsl command 
MAP output Meaning and action 


NO DCH POSTED 


Meaning: You must post a DCH. 


Action: Posta DCH using the post command. 
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tst 


Function 


Use the tst command to apply in-service and out-of-service tests to the 
posted DCHs. Depending on the state of the DCHs, either all the tests or the 
read-only memory (ROM) tests are applied. 


tst command parameters and variables 


Command Parameters and variables 


posted 


all ro! nondestr 
destr 
Parameters 


and variables Description 


all This parameter tests all posted DCHs simultaneously. 


all This default parameter, which is never entered, indicates that all tests are per- 
formed when the rom parameter is not entered. 


destr This parameter causes data destructive ROM tests to be performed. 


nondestr This default parameter, which is never entered, indicates non-destructive ROM 
tests will not be performed unless the response to the following prompt: 


it will include destructive memory test 
please confirm (“YES” or “NO”): 


is a yes. 


posted This default parameter, which is never entered, indicates that only the posted DC 
are tested if the all parameter is not entered. 


This parameter applies the ROM test only. 


Qualifications 
The in-service test does not affect transmissions on the D-channels or 
B-channels. 

Example 


The following table provides an example of the tst command. 
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tst (continued) 


Example of the tst command 


Example Task, response, and explanation 


tst 


Task: Perform ROM tests on a DCH. 


Response: It will include destructive memory test 
please confirm ("YES” or ”NO”): 


Explanation: A response is required for the test to continue. A yes will cause 
data destructive tests to be performed; a no will cause 
non-destructive ROM tests to be performed. 


Responses 


The following table provides explanations of the responses to the tst 
command. 


Responses for the tst command 
MAP output Meaning and action 
RELOAD THE PM 
Meaning: A test has failed. The PM must be reloaded. 


Action: Determine the load name by using the querypm command, then load the 
DCH using the loadpm command. 


REQUEST INVALID - LGC n IS OUT-OF-SERVICE 


Meaning: The posted LGC to which the posted DCH is linked must be in service 
(InSv) for testing to occur. 


Action: None 
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tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


DCH n INSERVICE TEST INITIATED 

DCH n TST FAILED 

SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EOPEC 
card_list 

DCH n INSERVICE TEST INITIATED 

DCH n TST PASSED 


Meaning: FAILED or PASSED appears only after the test is completed. Ifthe test 
failed, a list of suspected faulty cards. 


Action: If two or more DCHs are in the posted set and parameter all is specified, 
each DCH is tested in parallel. 


No DCH Posted 
Meaning: A DCH must be posted before it can be tested. 


Action: Posta DCH the enter the tst command again. 
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DCTLTP level commands 


Use the DCTLTP level of the MAP to access the data call tester (DCT) 
menu commands. 


Accessing the DCTLTP level 
To access the DCTLTP level, enter the following from the CI level: 
mapci;mtc;Ins;ltp;dctltp — 


DCTLTP commands 


The commands available at the DCTLTP MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DCTLTP commands 


Command 


deftime 
delete 
dial 
display 
hold 
inject 
next 


post 


quit 


release 


select 
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DCTLTP commands (continued) 


Command 


stop 
testbook 


DCTLTP menu 
The following figure shows the DCTLTP menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 


DCTLTP POST DELO BUSYO PREFIX 
Quit LCC PTY RNG...... LEN..... DN STA F S LTA TE RESULT 
Post_ 


Testbook 
Dial_ 
Inject_ 
Display_ 
Delete_ 


Hold 
Next_ 


Select_ 
DefTime_ 


hp 


Stop 
Release 


ONINSUVUPWDNDHOVOO IN U PBWMN OO 


hp 
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deftime 


Function 
Use the deftime command to perform the following functions: 
e set the test duration of 
- all subsequent dial commands issued in the same MAP session 


- all test calls initiated by the dial command currently executing in the 
active testbook 


- the test call currently executing in the active testbook 


e set the start time to be applied to the next dial command issued in the 
same MAP session 


e set the wait time on busy trunks 

e set the delay time in between test calls 

e reset test duration, start time, busywait, or delay to default times 
e query the deftime settings 


deftime command parameters and variables 


Command Parameters and variables 


deftime | busywait | resetdef 

<com> sec bsy_sec 
min bsy_min 
hour bsy_hour 
resetdef 
sec del_sec 
min del_min 
hour del_hour 

duration resetdef 
sec dur_sec 
min dur_min 
hour dur_hour 
day dur_day 


reset 
ddd hh 


Parameters 
and variables Description 


busywait This parameter sets the wait time on busy trunks to the time specified by the 
bsy_hour, bsy_min, or bsy_sec variable or to the default time of 120 sec when no 
variable is entered. 
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deftime (continued) 


deftime command parameters and variables (continued) 


Parameters 
and variables 


bsy_hour 


bsy_min 


bsy_sec 


day 


ddd 


delay 


del hour 


del_min 


del_sec 


duration 


dur_day 


dur_hour 


dur_min 


dur_sec 


Description 


This variable is the number of hours to which busywait is to be set to and has a range 
of 0-1. 


This variable is the number of minutes to which busywait is to be set to and has a 
range of 0-60. 


This variable is the number of seconds to which busywait is to be set to and has a 
range of 0-3200. 


This parameter indicates that the number of days of duration is to be specified and 
must be followed by the dur_day variable. 


This variable is the day of the week to which the start time is to be set and may take 
one of the values mon, tue, wed, thu, fri, sat, or sun. 


This parameter sets the delay time between test calls to the time specified by the 
del hour, del_min, or del_sec variable or to the default time of 5 min when no 
variable is entered. 


This variable is the number of hours to which delay is to be set and has a range of 
0-3. 


This variable is the number of minutes to which delay is to be set and has a range 
of 0-180. 


This variable is the number of seconds to which delay is to be set and has a range 
of 0-10800. 


This parameter sets the test duration to the time specified by the dur_hour, dur_mih, 
or dur_sec variable or to the default time of 900 sec when no variable is entered. 


This variable is the number of days to which the duration is to be set and has a rarlge 
of 0-3. 


This variable is the number of hours to which the duration is to be set and has a 
range of 0-72. 


This variable is the number of minutes to which the duration is to be set and has a 
range of 0-4320. 


This variable is the number of seconds to which the duration is to be set and has 
a range of 0-259200. 


This variable is the hour of the day to which the start time is to be set and has a rahge 
of 0-23. 
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deftime command parameters and variables (continued) 
Parameters 
and variables Description 


This parameter indicates that the number of hours of busywait, delay, or duration 
is to be specified and must be followed by the appropriate variable. 


This parameter indicates that the number of minutes of busywait, delay, or duratio 
is to be specified and must be followed by the appropriate variable. 


This variable is the minute of the hour to which the start time is to be set and has 
a range of 0-59. 


This parameter displays all the current deftime settings. 
This parameter resets the start time to now when it follows the start parameter. 
This default parameter, which is never entered, indicates that the default value of 


900 sec for duration, O sec for delay, or 120 sec for busywait will be set because 
no time-parameter-variable combination is entered. 


This parameter indicates that the number of seconds of busywait, delay, or duratiqn 
is to be specified and must be followed by the appropriate variable. 


This parameter sets the test start time specified by the ddd, hh, and mm variables 
or resets the start time to the default value of now if the reset parameter is entered. 


Qualifications 
The deftime command is qualified by the following exceptions, restrictions, 
and limitations: 


e The default values set by the deftime command apply to the current map 
session only. They are lost when the MAP is exited and entered again. 


e The deftime command can be issued if no testbook is active. 


e If a testbook is active, the deftime duration command also applies to the 
current test call and dial command of the active testbook, even 1f 
delayed. However, this does not apply to TERMRES testbooks. 


e When a start time is applied to a dial command, the start time is reset to 
now and must be set again if needed for another dial command. 


e If a start time has been set, the dial command prompts the user to 
confirm it before proceeding. 


e The busywait time is the time to wait on a busy trunk for a DCT test call 
before giving up. The busywait value applies to all dial commands that 
are issued from the same MAP session. 
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Examples 
The following table provides examples of the deftime command. 


Examples of the deftime command 


Example Task, response, and explanation 


deftime duration min 10 — 
where 


10 is the number of minutes to which duration is to be set 


Task: Define the time for test duration for 10 min. 
Response: DEFTIME DURATION command completed. 
DURATION set to 600 seconds. 
No testbook is active. 
Explanation: The test duration time is set to ten min (600 sec). The command 


did not affect any current test or dial command since no testbook 
was active. 


deftime busywait sec 1200 J 
where 


1200 is the number of seconds to which to which busywait is to be set 
Task: Define the busywait time as 1200 sec. 


Response: DEFTIME BUSYWAIT command completed. 
BUSYWAIT is set to 1200sec. 


Explanation: The command successfully set busywait to 1200 sec. 


deftime delay — 


Task: Reset delay time to default value. 


Response: DEFTIME DELAY command completed 
DELAY is set to Osec 


Explanation: The delay time is set to the default time of 0 sec. 
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Examples of the deftime command (continued) 


Example Task, response, and explanation 


deftime start mon 20 30 — 
where 


20 Is the hour of the day to which start is to be set 
30 is the minute of the hour to which start is to be set 


Task: Set start to 8:30 pm, Monday. 


Response: DEFTIME START command completed. 
START time is set at MON 20:30:00. 


Explanation: The start is successfully set to 8:30 pm, Monday. 
deftime query .| 
Task: Determine current deftime settings 
Response: Current DEFTIME settings: 
DURATION START DELAY BUSYWAIT 


100 NOW 0 120 


Explanation: All values are currently set to default values except duration. All 
values are in seconds. 


Responses 


The following table provides explanations of the responses to the deftime 
command. 


Responses for the deftime command 


MAP output Meaning and action 


DEFTIME DURATION command completed. 
DEFTIME BUSYWAIT command completed. 
DEFTIME DELAY command completed. 
DEFTIME START command completed. 


Meaning: These general messages are displayed when the deftime command is 
successfully executed. 


Action: None 
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Responses for the deftime command (continued) 
MAP output Meaning and action 
DURATION is set to <time>seconds. 


Meaning: The deftime duration command has set time to new value of <time>. All 
subsequent dial commands will have this time for their test duration. 


Action: None 
DURATION is still set to <time> seconds for this MAP. 
Meaning: The deftime duration cannot be confirmed due to an internal error. 
However, the duration to be applied for the next dial in this MAP session 
is still set. Also, a SWERR is generated. 


Action: Report the SWERR and try again later. 


DURATION applies to remaining calls of current DIAL command. 


Meaning: A dial command is executing when the deftime duration command is 


issued. The new duration is going to be applied to the remaining test 
calls in the current dial command. 


Action: None 


DURATION applies to current test call. 
Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is going to be applied to the current dial 
command. 


Action: None 


DURATION applies to current and remaining calls of DIAL command. 
Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is going to be applied to the call in progress 
and the remaining test calls to be made. 


None 
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Responses for the deftime command (continued) 


MAP output Meaning and action 


DURATION is too short for current test call. 


Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is not going to be applied to the call in 
progress because the elapsed time for the current call is already greater 
then the duration specified. However, the new duration will be applied to 
the remaining test calls of the current dial command. 


Action: None 


There are no remaining calls to apply DURATION to. 


Meaning: A dial command is executing when the deftime duration command is 
issued. The command was issued during the delay between calls. 


Action: None 
BUSYWAIT is set to <time> seconds. 
Meaning: The deftime busywait command successfully executed. 
Action: None 
DELAY is set to <time> seconds. 
Meaning: The deftime delay command successfully executed. 


Action: None 


START time is set at <{ddd hh:mm} or NOW>. 


Meaning: The deftime start command successfully executed. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the deftime duration command is issued. No 
current test or dial command is going to be affected by the command. 


Action: None 
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deftime (continued) 


Responses for the deftime command (continued) 
MAP output Meaning and action 
No DIAL command is executing. 
Meaning: No dial command is executing in the active testbook when the deftime 
duration command is entered. No dial command currently executing is 


affected by the command. 


Action: None 


No test call is running. 


Meaning: No test call is running at the time the deftime duration command is 
entered. No test currently running is affected by the command. 


Action: None 


A TERMRES testbook is active 


Meaning: A TERMRES testbook is active at the time the deftime duration 
command is issued. No test currently running in the TERMRES 
testbook is going to be affected by the command since duration of 
current tests in TERMRES testbooks cannot be modified by this 
command. 


Action: Access an originating testbook and try again 


Current DEFTIME settings: 
DURATION START DELAY BUSYWAIT 
<n> <day time> <n> <n> 

or NOW 


Meaning: This response to the deftime query command shows all current time 
settings. All times are in seconds. 


Action: None 


DURATION applies to all test calls of delayed DIAL. 


Meaning: A deftime duration command is executed while the current dial 
command is set to start sometime in the future. 


Action: None 
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Responses for the deftime command (continued) 
MAP output Meaning and action 
DCT is unavailable. System maintenance in progress. 


Meaning: The DCT process is temporarily unavailable due to system maintenance 
such as a PRESWACT. 


Action: Try again later 


DEFTIME command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The deftime command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. 


Action: None 
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Function 


Use the delete command to delete all or a subset of the test results belonging 
to the active testbook or to delete test results with no errors within a 
specified test range only. 


delete command parameters and variables 


Command Parameters and variables 


nolist norange 
Ist num to last_num 


list 
testbook 


Parameters 
and variables Description 


This parameter selects all tests in the active testbook for deletion. 


This parameter indicates that a list or range of test numbers, or both, is to be 
indicated. A list may be followed by a range which may be followed by an additio 
list of test numbers. The to parameter between test numbers distinguishes 
between a range and a list. 


This default parameter, which is never entered, indicates that all test results 
selected, with or without errors, will be deleted. 


This default parameter, which is never entered, indicates there is no list of test 
numbers. If the parameter t is used, there must be either a list or range of test 
numbers, or both, following it. 


This variable is a list of test numbers. The list may contain up to a maximum of 1( 
test numbers, each separated by a space. dst numbers may be any number in the 
range of 1-65535. 


This default parameter, which is never entered, indicates there is no range of test 
numbers. If the parameter t is used, there must be either a list or range of test 
numbers, or both, following it. 


1st_num This variable is the first test number in a range of test numbers. 


to This parameter must be used between the 7st_num and last_num variables of a 
range of test numbers. 
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delete command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is the last test number in a range of test numbers. 


This parameter selects only test results with no errors, for the specified test 
numbers, to be deleted. 


Qualifications 
The delete command is qualified by the following exceptions, restrictions, 
and limitations: 


e The maximum number of individual test numbers allowed in a delete 
command is 10. 


e A testbook cannot be deleted if a dial command is executing in it, if test 
results exist that belong to it, if it is active on another MAP, or if it is a 
TERMRES TESTBOOK. 


e Test numbers cannot be greater than 65 535. 
e The delete command applies to the active testbook. 
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Examples 
The following table provides examples of the delete command. 


Examples of the delete command 


Example Task, response, and explanation 


delete t 123 402 501 J 
where 


123, 402, and 501 are test numbers 
Task: Delete the test results for tests numbered 123, 402, and 501. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
3 test results DELETEd. 


Explanation: The results for the three selected tests have been deleted 


delete T 400 401 406 408 noerr — 
where 


400, 401, 406, and 408 are test numbers 


Task: Delete the test results without errors for the tests numbered 400, 
401, 406, and 408. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
2 test results DELETEd. 


Explanation: Only two test results were found to have no errors and were 
deleted. All four test results exist. 
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Examples of the delete command (continued) 


Example Task, response, and explanation 


delete test 640 to 659 J 
where 


640 and 659 are the first and last test numbers of a range 


Task: Delete the results of all tests in the range 640 
to 659. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
20 test results deleted 


Explanation: The results of all 20 tests in the range have been deleted. 
delete testbook — 


Task: Delete the active testbook. 


Response: Please confirm (y/n) 
>y 
DELETE command not executed. 
Testbook HOMER1 contains test results. 


Explanation: The active testbook cannot be deleted because it contains test 
results. 


Responses 


The following table provides explanations of the responses to the delete 
command. 


Responses for the delete command 


MAP output Meaning and action 


DELETE command not executed. 


Meaning: This is a general message displayed when the delete command is not 


successfully executed, for example, when the user replies no to the 
prompt, or an invalid option is entered. 


Action: None 
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Responses for the delete command (continued) 
MAP output Meaning and action 
DELETE command completed. 


Meaning: This is a general message displayed when the delete command is 
successfully executed. 


Action: None 
<n> test results DELETEd. 


Meaning: The delete command is completed and <n> is the number of test results 
deleted. 


Action: None 
Testbook <id> contains test results. 


Meaning: The delete testbook command cannot be executed because the 
testbook, identified as <id>, contains test results. 


Action: If the testbook is to be deleted, all test results in the testbook have to be 
deleted first using the delete all command. Test results should normally 
be backed up before being deleted. 


A dial command is executing in testbook <id>. 


Meaning: The delete testbook command is issued for a testbook with no test 
results in it while a dial command is executing, therefore, the delete 
command cannot execute,. 


Action: The testbook can be deleted by aborting the dial command with the stop 
command, or deleting all test results the delete all command and then 
reissuing the command The testbook can also be deleted by waiting for 
the dial command to be completed, then deleting the test results and 
reentering the delete testbook command. 


Testbook <id> is being used by another MAP. 


Meaning: The delete testbook command is issued for a testbook identified by <id> 
which is being used by another MAP. The command cannot, therefore, 
be executed. 


Action: Take no action or wait until no one is using the testbook and reissue the 
command. 


Menu Commands Reference Manual-DATA Through DTC! 
Volume 3 of 10 BCS36 and up 


D-12838 DCTLTP level commands 
delete (continued) 


Responses for the delete command (continued) 
MAP output Meaning and action 
Testbook <id> DELETEd. 


Meaning: This message is displayed if the delete testbook command was 
successful in deleting the active testbook. 


Action: None 


No Testbook is active. 


Meaning: The delete testbook command is issued when there is no testbook active 
and cannot, therefore, be executed. 


Action: None 


No test results exist in testbook <id>. 


Meaning: The delete t command was issued for a testbook without any test 
results. 


Action: None 


Test results queue is busy. 
A DELETE or DISPLAY command is being executed by another user. 
Try again later. 


Meaning: This message is the response to an attempt by the user to delete test 
results when the test results queue is being used by another user. 


Action: Wait a moment, then try again. 


TERMRES testbooks cannot be DELETEd. 


Meaning: This message is the response to an attempt to delete testbook 
TERMRESO or TERMRES1. These terminating testbooks cannot be 
deleted. 


Action: None 
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Responses for the delete command (continued) 


MAP output Meaning and action 


DELETE command failed. Try again 
Report swerr to the next level of support. 


Meaning: This message is printed when an internal error is encountered. 


Action: Report any SWERRS generated. 
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Function 
Use the dial command to perform the following: 


e sequentially dial one or more NSs from table DCTDIAL, and perform 
BERT testing on each one. Options include: 


- specify a repetition factor 


- request that BERP testing be dropped for free IBERTs if none is 
available 


- request the use of preselected trunk resources, IBERT resources, or 
both 


e temporarily halt the execution of the currently executing dial command 
e resume the execution of a halted dial command 


e abort the currently executing dial command, after the current test call is 
over 


dial command parameters and variables 


Command Parameters and variables 


nolist norange norepeat 
list 1st_dn last_dn repeat 


off 
pause 
resume 


dial 


(continued) 


Parameters 
and variables Description 


This parameter indicates that a list of DN indexes, a range of DN indexes, or both 
are to be entered. 


This parameter aborts the currently executing dial command after the current test 
call is finished. 


This parameter temporarily halts the execution of the currently executing dial 
command in the active testbook. 
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dial command parameters and variables (continued) 


Parameters 
and variables 


norepeat 


repeat 


count 


Description 


This parameter resumes the execution of the dial command halted by the pause 
parameter. 


This default parameter, which is never entered, indicates that the dial command will 
not operate on a list of DN indexes because no list is entered. 


This variable is a list of DN indexes. The list may contain up to 50 indexes, each 
separated by a space. A DN index number has a range of 1-2048. 


The default parameter, which is never entered, indicates that the dial command will 
not operate on a range of DN indexes because none is specified. 


This variable is the first DN index in a range of DN indexes to be specified and has 
a range of 1-2048. 


This variable is the last DN index in a range of DN indexes to be specified and has 
a range of 1-2048. 


This parameter must be used to separated the 7st_dn variable and last_dn variable 
in a range of DN indexes. 


This default parameter, which is never entered, indicates that the DN sequence will 
not be repeated because the repeat parameter is not entered. 


This parameter causes the DN sequence to be repeated the number of times 
indicated. 


This variable indicates how many times the DN sequence is to be repeated and hds 
a range of 1-3000. 


This default parameter is the number of times the DN sequence will be repeated 
if no range is specified with the repeat parameter. 


This default parameter, which is never entered, indicates that BERP testing is not 
dropped because the i parameter is not entered. 


This parameter requests dropping BERP testing to free IBERTS if none are 
available for DCT calls. 
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dial command parameters and variables (continued) 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that no preselected trun 


or IBERT resources are used because the s parameter is not entered. 


This parameter uses the preselected trunk resources, IBERT resources, or both. 


Qualifications 
The dial command is qualified by the following exceptions, restrictions, and 
limitations: 
e The dial command cannot be issued from testbook TERMRESO or 
TERMRESI that are reserved for incoming test calls. 


e The maximum number of test calls that can be requested by a single dial 
command is limited by the amount of available unused test numbers in 
the active testbook, with an absolute maximum of 65 535. 


e The maximum number of DN indexes allowed in a single dial command 
is 50. 


e The maximum number of simultaneous dial commands that can be run is 
20. 


e There can be only one executing dial command at a time in a given 
testbook. This includes delayed dial commands. 


e The dial command applies only to the active testbook. 
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Examples 
The following table provides examples of the dial command. 


Examples of the dial command 


Example Task, response, and explanation 


dial d 2 4 5 10 repeat 100 — 
where 


2,3,5,and 10 are the DN indexes 
100 is the repeat count 


Task: Dial and run BERT testing on DN indexes 2, 4, 5, and 10, and 
repeat the sequence 100 times. 


Response: The following SELECTions are being used: 
IBERT: Not Selected 
Outgoing trunk: Not Selected 
Bearer capability: 56KDATA 
DIAL command submitted. 
First test call assigned test number 241 


Explanation: BERT testing on DN indexes 2, 4, 5, and 10, is begun. 


dial D 2 4 5 to 10 repeat 100 s 
where 


2 and 4 are the DN indexes 
5 and 10 are the fist and last DN indexes in the range 
100 is the repeat count 


Dial and run BERT testing on DN indexes 2, 4, and 5-10 inclusive, 
and repeat the sequence 100 times using preselected IBERT 
resource. 


Response: The following SELECTions are being used: 
IBERT: 127 (HOST 00 0 00 00) 
Outgoing trunk: Not Selected 
Agent for translation: ICMF 0 
Bearer Capability: 64KDATA 
DIAL command submitted. 
First test call assigned test number 453 


Explanation: Command executes successfully. 
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dial (continued) 
Responses 
The following table provides explanations of the responses to the dial 
command. 
Responses for the dial command 
MAP output Meaning and action 
command not executed. 
PAUSE command not executed. 


RESUME command not executed. 
L OFF command not executed. 


Meaning: These are general messages displayed when the dial command is not 
successfully executed, for example, when the user specifies an invalid 
input to the command and a resource, such as IBERT, is not available. 


Check dial command syntax, and reenter the command. 
No testbook is active. 


Meaning: This message is displayed when a dial command is entered while no 


testbook is active. There must be an active testbook before issuing a 
dial command. 


Use the testbook command to access a testbook, and reissue the dial 
command. 


The following DN index ins not valid: <dn_index> 


Meaning: The DN index specified in a dial command ins not found in the table 
DCTDIAL 


Action: Reissue the dial command using DN indexes that exist in table 


DCTDIAL. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-136 DCTLTP level commands 
dial (continued) 


Responses for the dial command (continued) 


MAP output Meaning and action 


Too many test calls requested. Only <test_num_left> test number left. 


Meaning: More test calls are requested than the amount of available unused test 
numbers in the active testbook. The number of test calls requested is 
equal to the number of DN indexes multiplied by the repetition factor. 
The number of test numbers available, <test_num_left>, is 65 535 less 
the number already dialed in the testbook. The test numbers are 
sequential and not reuseable. To be able to reuse the test numbers, all 


of the test results must be deleted and the test numbers will then begin 
again at 1. 


Action: Reissue the dial command using a lower repetition factor or less DN 
indexes. Alternately, delete all the test results in the active testbook, or 
activate a new one and then reissue the dial command. 


No user outgoing trunk nor IBERT is selected. 
System selections will be used. 


Meaning: The parameter s is used in the dial command, but no trunk or IBERT 
selections have been made. The user is given the option of proceeding 
with the dial command using system selected resources. 


Action: Answer with a y or n. A y allows the dial command to proceed; an n 
aborts the command. 


Make you selections and reissue the dial command. 


Meaning: The user has chosen not to proceed with a system selected trunk or 
IBERT resource having responded with an n to the prompt. 


Action: Select trunk, IBERT, or both resources and reissue the dial command 
with the s option again. 


User outgoing trunk and IBERT selections will be ignored. 
System selections will be used. 


Meaning: This message is displayed when the option s is not used in the dial 
command while the trunk, bert, or both selections have been made. The 
user is given the option of proceeding with the dial command using 
system selected resources. 


Action: Answer with a y or n. A y allows the dial command to proceed; an n 
aborts the command. 
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Responses for the dial command (continued) 


MAP output Meaning and action 


Reissue DIAL with the “S” option. 


Meaning: The user has chosen not to proceed with a system selected trunk or 
IBERT resource having responded with an n to the prompt. 


Action: Select trunk, IBERT, or both resources and reissue the dial command 
with the s option again. 


WARNING. Start time set at hh:mm:ss dd mm YYYY. 
Do you want this DIAL command delayed until this time? 


Meaning: The dial command is issued after a future start time is set using the 
DEFTIME START command, where: 


hh:mm:ss is the hour, minute, and second 
dd is the day of the month 
mm is the month 


-  yyyy is the year 
It prompts the user to confirm the delay before proceeding. 


Action: Answer with a y orn. A y allows the dial command to proceed using the 
future date and time; an n aborts the command. 


Delayed dial not executed. 


Meaning: An n has been entered in response to the prompt for confirmation to use 
a future start time. 


Action: None 
Test call(s) delayed until hh:mm:ss dd mm YYYY. 


Meaning: A y has been entered in response to the prompt for confirmation to use a 
future start time. 


Action: None 
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Responses for the dial command (continued) 


MAP output Meaning and action 


DIAL command failed. Try again. 
Report swerr to the next level of support. 


Meaning: This message is displayed when the internal message has timed out. 


Action: Check for dial command execution by issuing the testbook command 
without parameters. The test numbers of the current, as well as the 
number to go, should not be NONE. Ifthey are, try the dial command 
again. Ifthe same message appears again, report the problem to the 
next level of support. Report the SWERR that is generated. 


Trial call failed for DN index <DN>. 


Meaning: The DCT network tool executes one trial call for each DN immediately 
following the receptions of a delayed dial command. These trial calls are 
intended to try out all the DNs targeted by the delayed dial command 
right away and to gain some level of confidence that the dial command 
will work at its scheduled time. At the first trial call failure encountered, 
the dial command is aborted and the failed DN is displayed. Since the 
dial command is aborted at the first trial call failure, there is no 
guarantee that it will work if the command is issued again without the DN 
that failed the first time. Some other DN may fail the trial call. 


Action: Check the failed DN or use another DN and try again. Report any 
problem with a working DN. 


Too many dial commands are executing. 
Meaning: This message is displayed if a dial command is issued after the 
maximum allowable number of 20 simultaneously executing dial 


commands has been reached. 


Action: Wait for a while, then issue the dial command again or abort one of the 
executing dial commands before reissuing the new one. 


A dial command is executing 


Meaning: A dial command is issued while another is still executing in the active 
testbook. 


Action: The user can either stop or dial off the currently executing dial 
command, or go to a testbook where no dial command is executing and 
reenter the dial command. 
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dial (continued) 


Responses for the dial command (continued) 


MAP output Meaning and action 


No dial command is executing. 


Meaning: No dial command is executing in the active testbook when a dial pause, 
dial resume, or dial off command is issued. 


Action: Use the testbook command to check the dial status. 


No memory left for test results. 
DELETE some test results to free memory. 


Meaning: A dial command is issued when no free storage is left to store rest 
results. This message means that memory resources are unavailable. 


Action: Dump some test results onto hard copy or magnetic storage, then delete 
these result to free some storage before reissuing the dial command. 


The following SESLECTions are being used: 
IBERT: <n> (<C11i/LEN>) 
Outgoing trunk: <Clli & mem> 
Agent for translation:<Clli or DN> 

Bearer capability: <bearer capability> 


Meaning: This is the normal response to a dial command. With the s option, the 
user selected IBERT or outgoing trunk will be displayed. 


The agent for translation and the bearer capability are used to emulate 
the originating agent for translation purpose. If none is selected 
(SELECT ORGDN/INTRK), the default (SELECT DEFINTRK) translation 
agent is used and displayed. If an originating DN or an incoming trunk & 
member are selected, they are displayed and used instead. 


Wait for next messages. 


Dial command submitted. 


Meaning: This is the normal response when dial command is successfully 
accepted and submitted for execution. 


Action: None 
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dial (continued) 


Responses for the dial command (continued) 
MAP output Meaning and action 
First test call assigned test number <number>. 


Meaning: This message is displayed when the dial is submitted for execution and 
a summary has been allocated for the first test call. 


Action: The user should go to a different testbook and reissue the dial 
command. 


Current test call will run to completion. 
Remaining test calls halted. 


Meaning: A dial pause command is accepted and submitted for execution while a 
test call is currently executing. 


Action: None 


Remaining tst calls halted. 


Meaning: This message is displayed when a dial pause command is accepted and 
submitted for execution while no test call is currently executing. 


Action: None 


Cannot PAUSE a delayed DIAL command 


Meaning: This message is displayed when a dial pause command is issued to act 
on a delayed dial command. 


Action: None 


Resuming execution of remaining test calls. 
Meaning: A dial resume command is accepted and submitted for execution. 


Action: None 


Current test call will run to completion. 
Remaining test calls aborted 


Meaning: A dial off command is accepted and submitted for execution while a test 
call is currently executing. 


Action: None 
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dial (continued) 


Responses for the dial command (continued) 


MAP output Meaning and action 


Remaining test calls aborted. 


Meaning: A dial off command is accepted and submitted for execution, and no test 
is currently executing. 


Action: None 
Cannot dial off a delayed dial command 


Meaning: A dial off command is issued and submitted for execution on a delayed 
dial command. To abort a delayed dial command, the stop command 
must be used. 


Action: Issue a stop command to abort the delayed dial. 


Missing SELECTions for translation purposes. 
SELECT one of the following: 

- Incoming trunk or originating DN 

- Default incoming trunk 


Meaning: A dial command is attempted without making appropriate translation 
selections. After a default translation agent (incoming trunk and 
member), this message should not appear. 


Action: Use the select command to select a default translation agent, an 
incoming trunk, or originating DN and try again. 


Too many DNs requested. Maximum is 50. 


Meaning: A dial command with too many DNs in the specification is attempted. 
The total number of DNs requested must be less than or equal to 50. A 
range of 1-51, for example, would cause this message to appear if all 
the DNs in the range were datafilled. 


Action: Submit the dial command again with fewer DNs specified. 
The dial sequence is not PAUSEd. 


Meaning: A dial resume command is issued when there is not an active dial 
sequence that has been paused. 


Action: None 
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Responses for the dial command (continued) 
MAP output Meaning and action 
Testing DN index: <DN>. Please wait. 


Meaning: A delayed dial command is issued. Trial calls proceed and the message 
appears for each DN index that is called. 


Action: None 


Trial call successful for DN index: <DN>. 


Meaning: A delayed dial command is issued. Trial calls proceed and this message 
appears for each successful DN index. 


Action: None 
Current tst call is the last one in the current dial command. 

Meaning: A dial pause or dial off command is issued, and only one test call 
remains in the dial sequence. The only result of tne command will be this 
message because the dial pause and commands apply to remaining test 
calls, not the currently running one. 

Action: Issue stop command to abort last test call in the dial command. 


No IBERT available. 


Meaning: A dial command is issued, and no IBERTs are available to make the test 
calls. 


Action: Check the IBERT involved in this test call and inspect the datafill in table 
FMRESUSE and FMRESINV to see that the IBERT is properly datafilled. 


DCT is unavailable. System maintenance in progress. 


Meaning: A dial command is issued when DCT processing software is unavailable 
to handle dial command requests due to system maintenance. 


Action: Wait, and try again. 
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Function 
Use the display command to perform the following: 


e display current selections and settings for trunk, IBERT, duration, 
busywait, and delay 


e isplay the test results of a particular test in the active testbook and 
optionally choose to display only test summaries 


e display test results as they occur (real-time) for the current and 
subsequent tests in an active originating testbook, or one of the current 
tests for TERMRES testbooks 


e stop the display of real-time errors 


display command parameters and variables 


Command Parameters and variables 


display current 
off 
on 
t tst_num nosumm 
summ 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that current selections 
and settings will be displayed because no parameter is entered with the command 


This parameter deactivates continuous display mode. Real-time error display for 
currently running test will stop. 


This default parameter, which is never entered, indicates that a summary of test 
results will not be displayed because the summ parameter is not entered. 


This parameter activates continuous display mode. Errors are displayed as they 
occur for all subsequent tests. In TERMRESO or TERMRES1 this parameter has 
to be followed by a test number, tst_num variable, because display must be 
requested for one test at a time. 


This parameter causes a summary of test results for the selected tests to be 
displayed. 
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display command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter indicates that a test number for results display is to be indicated b 
the tst_num variable that must follow it. 


tst_num This variable is the number of a test for which results are to be displayed. This 
variable must follow the t parameter and the on parameter if working in the 
TERMRESO or TERMRES1 testbook. The tst_num variable has a range of 
1-65 535. 


Qualifications 


The display command is qualified by the following exceptions, restrictions, 
and limitations: 


e The difference between this command and the nonmenu version of the 
display command at the DCTTOOL level is that only one summary can 
be displayed and only the option summ is recognized in menu command. 


e The display command with the test number on and off parameters 
applies only to the active testbook. If no testbook is active, the 
command is ignored. Only the display command with no parameters can 
be issued if no testbook is active. 


e The display command is ignored if a delete command is being executed 
in the same testbook by any DCT MAP. The test result queue (one for 
each testbook) is unavailable for reading when a delete command is 
acting on it. 


e Real-time error cannot be displayed on two different MAPS for the same 
test; that is, if a display on command is currently executing on one MAP 
for testbook<id>, it is ignored if issued from another MAP for the same 
testbook <id>. 


e The display on command is automatically stopped if the active testbook 
is changed. 
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Examples 
The following table provides examples of the display command. 


Examples of the display command 


Examples Task, response, and explanation 
display . 


Task: Display current selections and settings: 


Response: 
Current SELECTions and settings: 
Outgoing Trunk: OGMF 2 
IBERT: 2 (HOST 00 0 00 00) 
Agent for translation: Default translation agent 
Bearer capability: 56KDATA 
Default translation agent: ISUPICIT 0 
Default bearer capability: 64KDATA 
Duration: 900 
Busywait: 120 
Delay: 10 
Start time: NOW 


Explanation: Current selections and settings are displayed when no parameters 
are entered with the display command. 


display on J 


Task: Activate continuous display mode. 


Response: DISPLAY command completed. 
Continuous DISPLAY is ON. 


Explanation: Continuous display mode is activated. 
display off — 
Task: Deactivate the continuous display mode. 


Response: DISPLAY command completed. 
Continuous DISPLAY is OFF. 


Explanation: Continuous display mode is deactivated. 
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Responses 


The following table provides explanations of the responses to the display 
command. 


Responses for the display command 


MAP output Meaning and action 


DISPLAY command completed. 


Meaning: This is the general message displayed when the DISPLAY command is 
successfully executed. 


Action: None 


DISPLAY command not executed. 


Meaning: This is the general message displayed when the DISPLAY command is 
not successfully executed. It is always followed by additional 
explanation. 


Action: None 


Current SELECTions and settings: 

Outgoing Trunk: <CLLI/member> 

IBERT: <n> (<ILC LEN>/<DTU mem>) 
Agent for translation: <DN/CLLI & mem> 
Bearer capability: <BC name> 

Default translation agent: <DN/CLLI & mem> 
Default bearer capability: <BC name> 

Duration: <# seconds> 
Busywait: <# seconds> 

Delay: <# seconds> 

Start time: <ddd hh:mm> or <now> 


Meaning: This message is the response to the display command with no 
parameters. It is a list of all selections and settings that have been 
made earlier. 


If any of the selections have not yet been made, “Not Selected,” is 
displayed instead of the selection. 


Action: None 
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Responses for the display command (continued) 


MAP output Meaning and action 


No testbook is active 


Meaning: No testbook is active when the display command with parameters is 
issued. If no testbook is active, no test results can be displayed and no 
real-time display can be initiated or stopped. 


Action: None 


DELETE command executing. Try again alter. 


Meaning: The user tries to display test results while a delete operation is being 
performed by another user in the same testbook. 


Action: Try again later. 


No test results in testbook <id>. 
Meaning: No test results exist in the active test book. 


Action: None 


Testbook ID: <id> Test number: <number> 
Peer test number: <number> 

Call duration: <number> DN: <dialed DN> 
Start time: <dd month hh mm ss> Stop time: <dd month hh mm ss> 
IBERT: <n> (<ILC LEN>) Peer IBERT: <n> (<ILC LEN>) 
Errors <n> Errored seconds: <n> 
Error free seconds: <n> Number of sync losses: <n> 
Blocks received: <n> Block size: 511 or 2047 bits 
Call status: <status> Call setup time: <n> 
Call termination reason <reason> 
5-MIN WINDOW START TIME ERRORED-SECONDS ERRORS 

<TIMESTAMP> <NUMBER> <NUMBER> 


<TIMESTAMP> No data available. IBERT out of sync. 


Meaning: Display produced by display t test_ num command. The message for an 
intraswitched call shows the rest results for a single test. It includes the 
results summary and 5-min bin results (there may be up to 20 5-min bin 
results.) There is a possibility of the IBERT being out of synch when 
polled for the 5-min BIN as the message indicates. 


Action: None 
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Responses for the display command (continued) 


MAP output Meaning and action 


Testbook ID: <id> Test number: <number> 
Call duration: <number> DN: <dialed DN> 
Start time: <dd month hh mm ss> Stop time: <dd month hh mm ss> 
IBERT: <n> (<ILC LEN> or <DTU mem>) Trunk member: <clli> <member> 
Errors <n> Errored seconds: <n> 
Error free seconds: <n> Number of sync losses: <n> 
Blocks received: <n> Block size: 511 or 2047 bits 
Call status: <status> Call setup time: <n> 
Call termination reason <reason> 
5-MIN WINDOW START TIME ERRORED-SECDONDS ERRORS 

<TIMESTAMP> <NUMBER> <NUMBER> 


<TIMESTAMP> No data available. IBERT out of sync. 


Meaning: Display produced by display t test_ num command. The message for an 
interswitched call shows the rest results for a single test. It includes the 
results summary and 5-min bin results (there may be up to 20 5-min bin 
results.) There is a possibility of the IBERT being out of synch when 
polled for the 5-min BIN as the message indicates. 


None 
Next summary unavailable 


Meaning: In a dial sequence, the next summary cannot be allocated due to 
memory shortage or the DCT_MEM_LIMIT is reached. 


Action: Free some summaries and try again. 
Test number is required in TERMRES testbooks. 


Meaning: A display on command in a TERMRES testbook. The test number must 
be specified in a TERMRES testbook. 


Action: Use the testbook command to see the list of current test calls running in 
the TERMRES testbook; then, reenter the display on command using 
the test number. 
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display (continued) 


Responses for the display command (continued) 
MAP output Meaning and action 


Test call <number> is not running in testbook <TERMRESO or TERMRES1>. 


Meaning: The test call number specified by the display on command for the 
TERMRES testbook is not currently running. 


Action: 


Use the testbook command to determine what test are running. 
WARNING: 


Test number ignored. 


TEst <id> is an originating testbook. 


Meaning: A test number is specified for continuous display in an originating 


testbook. The test number is simply ignored and the command is 
executed as if no test number were specified. 


Action: None 


Continuous DISPLAY is already ON. 


Meaning: The continuous display mode has already been turned on. 
Action: None 


Continuous DISPLAY is being used by another MAP. 


Meaning: The continuous display mode has been turned on at another MAP 
position. 


Action: None 


Continuous DISPLAY is ON. 


Meaning: The display on command has successfully executed. 


Action: None 


Continuous display is already off. 


Meaning: Continuous display mode is off when display off command is entered. 
Action: None 
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Responses for the display command (continued) 


MAP output Meaning and action 


Testbook Test Number of Errored 
ID number bit errors seconds Timestamp 
<ID> T:<n> E:<n> ES:<n> <time> 


<ID> T:<n> E:<n> ES: <n> S:<n> <time> 
<ID> T:<n> IBERT is out of sync <time> 
<ID> T:<n> Cout not poll IBERT <time> 


Meaning: This message is the contents of the continuous display response. The 
last two lines are displayed only if the IBERT was out of sync or polling a 
bad IBERT. 


Action: None 
Test number <n> not found. 
Meaning: The command display t <n> is entered where no test number <n> exists. 
Action: Use the testbook command without any parameters or the count 
command to determine what tests are running. Use the DCTTOOL level 


display all command to display all test numbers. 


DCT is unavailable. System maintenance in progress. 


Meaning: A display on or display off command is entered when DCT processing 
software is unavailable to handle the command. 


Action: Try the command again later. 


DISPLAY command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The internal DCT MAP to DCT process message to initiate continuous 
display is not acknowledged. Positive feedback cannot be given to the 
user about the status of the command. A SWERR is generated 
indicating that a time out has occurred. 


Try the command again later, and report the SWERR. 
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Function 


Use the hold command to move the line in the control position to a spare 
hold position, and move the next line from the posted set, if any, to the 
control position. 


hold command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualification 


The hold command is qualified by the following exceptions, restrictions, and 
limitations: 


e Ifa line in the control position is one of a posted set, it is removed from 
the posted set when it is placed in a hold position. 


e This command also applies to Integrated Services Digital Network 
(ISDN) lines. There are no additional responses for ISDN lines. 


Example 
The following table provides an example of the hold command. 


Example of the hold command 


Example Task, response, and explanation 


Task: Move the line in the control position to a spare hold position, and 
move the next line from the posted set to the control position. 


Response: The system transfers the dn of the line in the control position, and 
all other line information displayed to the right of it, to an available 
hold position. The system then places another line in the control 
position. The quantity beside the label POST decreases by one. 


Explanation: The system transfers the line in the control position, which is part of 
a posted set, and its associated data to an available hold position. 
The system places the next line in the posted set in the control 
position. 
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Responses 


The following table provides explanations of the responses to the hold 
command. 


Responses for the hold command 
MAP output Meaning and action 
ALL HOLD POSITIONS FILLED 
Meaning: A line occupies each of the hold positions. 


Action: None 


The dn of the line in the control position, and all other line information displayed to the right of it, is 
transferred to an available hold position. 


Meaning: The system transfers the line in the control position and its associated 
data to an available hold position. Since the line in the control position is 
not part of a posted set, no other line is placed in the control position. 


None 


The system transfers the dn of the line in the control position, and all other line information 
displayed to the right of it, to an available hold position. The system then places another line in the 
control position. The quantity beside the label POST decreases by one. 


Meaning: The system transfers the line in the control position, which is part of a 
posted set, and its associated data to an available hold position. The 
system places the next line in the posted set in the control position. 


Action: None 
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Function 
Use the inject command to inject up to 16 bit errors in the current test. 


inject command parameters and variables 


Command Parameters and variables 


inject errors num no t 
t tst_ num 


Parameters 
and variables Description 


errors_num This variable is the number of bit errors to be injected and has a range of 1-16. 


no t This default parameter, which is never entered, indicates that no test number will 
be specified. 


This parameter indicates that a test number will be specified, and must be followed 
by the tst_num variable. 


ist num This variable is the number of the test to have bit errors injected into itand has a 
range of 1-65535. 


Qualifications 


The inject command is qualified by the following exceptions, restrictions, 
and limitations: 


e The inject command is ignored if no testbook is active. 


e The inject command issued without a test number applies to the current 
test of originating testbooks. If no test is running in the active testbook, 
the inject command is ignored 


e If the inject command is issued with a test number, that number has to 
correspond to the current test in originating testbooks, or to one of the 
running tests in TERMRES testbooks to avoid the command being 
rejected. 
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Examples 
The following table provides examples of the inject command. 


Examples of the inject command 


Example Task, response, and explanation 


inject 2 
where 


2 is the number of bit errors to be injected 
Task: Inject two bit errors into the currently running test. 


Response: 2 bit error(s) INJECTed into test 123 of 
testbook Z1. 


Explanation: Command is successful 


inject 11 t 147.1 
where 


11 is the number of bit errors to be injected 
147 is the number of the test affected 


Task: Inject 11 bit errors into test 147. 


Response: INJECT command not executed. 
Test 147 is not running in testbook LIEM 


Explanation: The current testbook is LIEM and test 147 is not running in it. 
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Responses 


The following table provides explanations of the responses to the inject 
command. 


Responses for the inject command 
MAP output Meaning and action 
INJECT command not executed. 


Meaning: The inject command is not successfully executed because a wrong 
parameter is entered or there is no running test to which to inject errors. 


Action: None 
<n> bit error(s) INJECTed into test <m> of testbook <id>. 
Meaning: The number of bit errors <n> have been injected into test number <m> 
of the testbook identified by <id> indicating successful completion of the 


inject command. 


Action: None 


No test call running in testbook <id> 


Meaning: No test call is running in the active testbook when the inject command is 
issued. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the inject command is issued. The inject 
command applies only to the active testbook. 


Action: Access the testbook, and try again. 
Test <n> is not running in testbook <id> 


Meaning: The inject command is issued with a test number that does not 
correspond to a test currently running. 


Action: Use the testbook command to check the running test numbers. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-156 DCTLTP level commands 
inject (continued) 


Responses for the inject command (continued) 
MAP output Meaning and action 
Test number must be specified in TERMRES testbooks. 

Meaning: The inject command is issued whthout a test number when the active 
testbook is either TERMRESO or TERMRES1. Because many test calls 
can be concurrently running in TERMRES testbooks, the test call to 
inject error into must be specified. 

Action: Reissue the inject command with the desired test number. 


No dial command is executing. 


Meaning: The inject command is issued for a testbook in which there is no dial 
command running. 


Action: Issue a dial command, then reissue the inject command. 
An INJECT command is running in test <n> of testbook <id>. 

Meaning: This response is generated during an ILC-ILC call. It will only appear if 
the inject command is issued in the originating testbook and in the 
corresponding TERMRES test. Simultaneous injects into the same test 
call of an ILC-ILC call is not supported. 


This response also occurs when the inject command is entered on the 
same testbook from two different MAP sessions. 


Action: None 
IBERT is out of sync. 


Meaning: The inject command is issued while the IBERT involved in the test call is 
out of sync. 


Action: Wait for IBERT to reestablish sync, and reissue the command. 
IBERT is unavailable. 


Meaning: The inject command is issued while the IBERT involved in the test call 
cannot communicate with the DCT process. 


Action: Repeat the command when IBERT has regained messaging. 
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Responses for the inject command (continued) 
MAP output Meaning and action 
Delayed DIAL has not started yet. 


Meaning: The inject command is issued before a delayed dial command has 
started a test call. 


Action: Wait for delayed dial to start a test call, then reissue inject command. 
DCT is unavailable. System maintenance in progress. 


Meaning: The inject command is issued while the DCT process is initializing. 


Action: Wait for DCT process to finish initializing, then reissue the inject 
command. 


INJECT command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The inject command encounters an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try again. 


Action: Report any SWERRS. 
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next 


Function 


Use the next command to place the next higher PM of the posted DTC set 
into the control position. 


next command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that the next PM in the 
post set, regardless of type, will be posted because no PM type is specified. 


This variable specifies a PM type and enables the system to select a specific PM 
type to post. Use the disp command to display the list of PM types in the posted 
set. The system selects the PMs in the sequence displayed by this list. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


The following table provides an explanation of the response to the next 
command. 


Responses for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed PM is the last in the posted set of PMs. 


Action: None 
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Function 


Use the post command to select a specific DTC upon which action is to be 
performed by other commands. 


post command parameters and variables 


Command Parameters and variables 


pm_type nnn ...ann 


Parameters 
and variables Description 


This variable identifies a PM of node-type DTC when dtc is entered. If a level of tHe 
node-type is already accessed, the pm_type may be omitted from the command 
entry. A PM in the control position of the posted set is the default. 


This variable identifies the discrimination number of the DTC to be posted. The 


range is 0-127. When more than one PM is to be posted, the discrimination num- 
bers are entered with a blank space separating them. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 
limitations. 


e The post command must be used before using the commands trnsl, tst, 
bsy, rts, and offl. 


e When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs that are present in the office configuration. For parameters that do 
not apply, one of several responses indicates that it is ignored. 
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Examples 
The following table provides an example of the post command. 


Examples of the post command 


Example Task, response, and explanation 


post dtc 8. 
where 


8 is the descrimination number of the DTC to be posted. 
Task: Post DTC 8. 
Response: DTC 8 InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 


Unitl: Inact InSv 


Explanation: DTC 8 is posted. 


Responses 


The following table provides an explanation of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


NO PM POSTED 


Meaning: A PM level is accessed without any PM being posted. 


Action: None 
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post (end) 


Responses for the post command (continued) 
MAP output Meaning and action 
pm pm_number n_state LINKS OOS: CSIDE nn PSIDE nn 


UNIT 0: activity u_state MTCE /LOADING: nnnn 
UNIT 1: activity u_state MCTE LOADING: nnnn 


Meaning: When a PM is posted, its status is displayed, where: 


pm is one of the types of PM types listed in the PM 
status code table at the PM level commands. 


pm_number is the discrimination number of the PM type. 


n_state is the state of the PM node. The displayed state 
depends on the state of one or both units. 


LINKS_OOS indicates the quantity of equipped C-side and P-side 
links that are out of service because they are either 
system busy or manually busy. 


activity indicates which unit is available for call processing 
and which unit is on standby. ACT means the unit is 
active and able to handle call processing; INACT 
means the unit is on standby (inactive). 


is the status of a unit. 


indicates the unit is undergoing maintenance initiated 
manually or by the system (displayed with u_states 
ManB and SysB, respectively). MTCE is present 
only while maintenance is occurring. 


/LOADING: indicates the unit is being updated with datafill, where 
nnnn is an increment of the load. 


Action: None 


<PM> <num> InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 
Unitl: Inact InSv 


Meaning: The specified <PM> nunmber <num> is posted. 


Action: None 
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quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DCTLTP level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DCTLTP level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DCTLTP level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DCTLTP level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DCTLTP level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DCTLTP level commands D-167 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DCTLTPlevel with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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release 


Function 


Use the release command to terminate the current test call of the active 
testbook. 


release command parameters and variables 


Command Parameters and variables 


release There are no parameters or variables. 


Qualifications 


The release command is qualified by the following exceptions, restrictions, 
and limitations: 


e When the current test call is released, the next test call in the executing 
dial command is started immediately, even if a delay time is specified, 
unless it is paused. If is is paused, the next test call is started when the 
dial command is resumed. 


e The release command is only valid if a testbook is active. 


e The release command applies only to the current test of the active 
testbook. If no test is running, no test is released, even if dial command 
is executing and is waiting between calls. 


e Test summaries show if atest has been released. 
e The release command cannot be executed in a TERMRES testbook. 


Example 
The following table provides an example of the release command. 


Example of the release command 


Example Task, response, and explanation 
release | 


Task: Release current test. 


Response: RELEASE command completed. 
Current test call in testbook xv123 is RELEASEd. 


Explanation: The current test is released. 
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release (continued) 


Responses 


The following table provides explanations of the responses to the release 
command. 


Responses for the release command 
MAP output Meaning and action 
RELEASE command not executed. 


Meaning: General message indicating unsuccessful execution of release 
command. 


Action: None 


RELEASE command completed 


Meaning: General message indicating successful execution of release command. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the release command is entered. The 
release command is only valid when a testbook is active. 


Action: None 


Current test call in testbook <ID> is RELEASEd. 
Meaning: Test call has been successfully released. 


Action: None 


Proceeding with next test call. 
Meaning: The test call released by the release command is not the last one in the 
current dial command. It indicates to the user that execution of the next 
test call is going to start. 


Action: None 


Last test call in DIAL has been RELEASEd. 


Meaning: The last test call in the dial has been released; therefore, the entire dial 
command is finished. 


Action: None 
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Responses for the release command (continued) 
MAP output Meaning and action 
A TERMRES testbook is active. 


Meaning: A TERMRES testbook is the active testbook when the release command 
is entered. Tests in TERMRES testbooks cannot be released. 


Action: None 
No DIAL command is executing. 


Meaning: A release command has been entered in a testbook that has no dial 
command running. 


Action: None 
The DIAL sequence is PAUSEd. 


Meaning: A release command has been entered while a dial command is being 
paused. The release is simply ignored. 


Action: None 


Current delay to next test call is RELEASEd. 


Meaning: A release has been issued during the delay between calls in the dial 
sequence. The delay is cancelled, and the next call is started. 


Action: None 
Delayed DIAL has not started yet. 


Meaning: A delayed DIAL has been issued. The release 3 cannot release a test 
call that has not started executing yet. 


Action: None 


DCT is unavailable. System maintenance in progress. 


Meaning: The DCT process is temporarily unavailable due to the process dying. 
The DCT process will restart itself; then, the full set of DCT commands 
will be available. 


Action: Wait, and try again later. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-172 DCTLTP level commands 
release (end) 


Responses for the release command (continued) 
MAP output Meaning and action 


RELEASE command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The release command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. 


Action: Report any SWERRS, and try the command again. 
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select 


Function 
Use the select command to perform the following functions: 


e select a particular IBERT for use in subsequent dial commands that use 
the S option. The IBERT can be either an ILC or DTU 


e select a particular outgoing trunk group or trunk group and trunk 
member for use in subsequent dial commands that use the S option 


e select the posted item (trunk group or member ILC) for use in 
subsequent dial commands that use the S option 


e select an incoming trunk for translation purposes, with optional bearer 
capability when it is different from the default of 56KDATA 


e select an originating trunk for translation purposes, with optional bearer 
capability when it is different from the default of 56KDATA 


e select a default translation agent (default incoming trunk and member). 
which will apply for all DCT testbooks in the given office 


e deselect all previously made selections 
e display selections 


select command parameters and variables 

Command Parameters and variables 

select posted 
clear 
defintrk 
intrk 


bc_name 


orgdn 
bc_name 


dtu_num 


tk_grp 
tk_num 


ibert_num 


site drawer circuit 
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select command parameters and variables 


Parameters 
and variables 


drawer 
dtu 
dtu_num 
frame 


ibert 


ibert_num 


intrk 


Description 


This default parameter causes all previous selections to be deselected and does 
not need to be entered. 


This parameter indicates that bearer capability is to be selected with the incoming 
trunk 


This variable is the identification of the bearer capability of the incoming trunk 
and must be one of the following: 


speech 
56kdata 
64kdata 


This variable is the circuit number and has a range of 0-99. 
This parameter deselects all previous selections. 


This parameter selects an incoming trunk for translation emulation like the intrk 
parameter, but it is also the default for all testbooks. The defintrk parameter must 
be followed by tk_grp or tk_num variable, or bc parameter and bc_name variable. 


This variable is the drawer number and has a range of 0-99. 

This parameter indicates that a DTU member is to be specified. 

This variable is the number of the DTU member and has a range of 0-9999. 
This variable specifies the frame number of the ILC and has a range of 0-511. 


This parameter indicates that an IBERT number is to be specified from table 
FMRESINV. 


This variable is the number of the IBERT and has a range of 0-127. 


This parameter selects an incoming trunk for translation emulation and must be 
followed by tk_grp or tk_num variable, or bc parameter and bc_name variable. 


This parameter indicates that an ILC (LEN) is specified. 


This default parameter, which is never entered, indicates that no bearer capability 
is to be selected for the incoming trunk. 
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select command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is a string defining the originating DN. 
This parameter indicates that an originating DN is specified. 


This default parameter, which is never entered, indicates that the posted item 
(trunk, trunk member, DTU, ILC) will be selected because the select command is 
entered with no parameters. 


This parameter causes all previously made selections to be displayed. 
This variable is a string with the site name. 
This variable is the trunk group clli used with the g, intrk, or defintrk parameters. 


This variable is the number of the trunk member used with the g, intrk, or defintrk 
parameters and has a range of 0-9999. 


This variable is the unit number of the ILC and has a range of 0-9. 


Qualifications 


The select command is qualified by the following exceptions, restrictions, 
and limitations: 


e Selections apply on a testbook basis. Selections other than the default 
translation agent are specified only once in each testbook. 


e The command select ibert <n> stores the actual IBERT circuit id and not 
the IBERT number in table FMRESINV. Therefore, if the datafill in this 
table is changed, select query and display will show the new number 
assigned to this IBERT. If this tuple is deleted, NIL is shown in place of 
the IBERT number. The IBERT circuit ID (that is DTU 0) is still shown. 


e The default translation agent once selected will apply to all testbooks in 
the given switch or office. 
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Examples 


The following table provides examples of the select command. 


Examples of the select command 


Example 


select — 


Task, response, and explanation 


Task: Select the currently posted ILC 
Response: Trunk group OTTMTL23 SELECTed 


Explanation: The SELECT command without any parameters selects the posted 
item. 


select g isupibnog 13. 


where 


isupibnog 


13 


is the name of the trunk group 
is the number of the member of the group to be selected. 


Task: Select member 13 of trunk group isupibnog. 


Response: Trunk group ISUPIBNOG member 13 SELECTed. 


Explanation: Member 13 of trunk group isupibnog is selected. 


select dtu 7 J 


where 


7 


is the number of the DTU to be selected 
Task: Select IBERT DTU 7. 
Response: IBERT DIU 7 SELECTed. 


Explanation: Selection is successful. 
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Examples of the select command (continued) 


Example Task, response, and explanation 


select 1 host 0123 
where 


host is the site name 
is the frame number 
is the unit number 
is the drawer number 
is the circuit number 


Task: Select circuit 4 in drawer 3 of unit 2 in frame 1 of host ILC. 
Response: IBERT ILC LEN HOST 00 0 00 00 SELECTed. 


Explanation: The specified IBERT ILC LEN is selected. 
select clear — 


Task: Clear all previous selections 


Response: The following selections will be cleared in this 
testbook: 
- Outgoing trunk/member 
- IBERT 
Please confirm (“YES”, “Y”, “NO”, or “N”): 
>Y 
Outgoing trunk and IBERT SELECTions have been 
CLEARed. 


Explanation: 
select query .| 


Task: Display all previous selections. 


Response: 
Current SELECTions: 
Outgoing trunk: ISUPIBNOG 0 
IBERT: DTU 9 
Agent fro translation: default translation agent 
Bearer Capability: 56KDATA 
Default translation agent: ICMF 
Default bearer capability:64KDATA 


Explanation: All previous selections are displayed. 
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Examples of the select command (continued) 


Example Task, response, and explanation 


select orgdn 7657962 bc 64KDATA .| 
where 


7657962 is the originating dn 
Task: Select the originating DN 7657962. 
Response: Originating DN 7657962 SELECTed for translation. 


Explanation: The specified originating dn is selected. 


Responses 


The following table provides explanations of the responses to the select 
command. 


Responses for the select command 


MAP output Meaning and action 


SELECT command not executed 


Meaning: The select command is not successfully executed because the user 
replies no to the confirmation prompt or an invalid parameter is entered. 


Action: None 


Trunk group <clli> SELECTed. 


Meaning: The select command has successfully selected a trunk group. 


Action: None 
Trunk group <clli> member <member> SELECTed. 
Meaning: The select command has successfully selected a trunk member. 


Action: None 
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Responses for the select command (continued) 
MAP output Meaning and action 


IBERT DTU <DTU mem> SELECTed. 
Meaning: The select command has successfully selected a DTU. 


Action: None 


IBERT ILC LEN <ILC len> SELECTed 


Meaning: The select command has successfully selected an ILC. 
Action: None 
Post set is empty. 


Meaning: The select command is issued with no parameters and nothing is 
posted. 


Action: POST an outgoing trunk or ILC and reissue the command. 
Trunk group <clli> does not exist. 
Meaning: The trunk selected is not correctly datafilled or not correctly entered. 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM to determine 
where error is. Correct error and reissue command. 


Trunk group <clli> does not use Rl or ISUP signalling. 


Meaning: The trunk member selected does not use R1 or ISUP signaling types. 


Action: Select another trunk which uses R1 or ISUP signaling. In table 
TRKSGRP, the fields SIGDATA must be either C7UP or STD. Also, 
OPULSTYP/IPULSTYP must be MF in case of STD signaling. 


Trunk group <clli> member <number> does not exist. 

Meaning: The trunk member selected is not datafilled. 

Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 
IBERT DTU <DTU mem> does not exist. 

Meaning: The DTU being selected is not datafilled 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 
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Responses for the select command (continued) 


MAP output Meaning and action 


IBERT ILC LEN <ILC len> does not exist. 
Meaning: The ILC being selected is not datafilled. 


Action: Check tables LNINV and FRMRESINV. 


The following selections will be cleared in this textbook: 
- Outgoing trunk/member 
- Ibert 
_ Emulated translation agent 


Meaning: This message confirms resetting the outgoing trunk and IBERT 
selections after the user has issued a select clear command. The last 
item is only shown when the option ALL is specified. 


Action: None 


Current SELECTions: 
Outgoing trunk: <trkclli> <trkmem> 
IBERT: <<ILC LEN> or DTU <DTU mem>> 


Agent for translation: <trunk>/<DN> or Default translation agent 
Bearer Capability: <BC name> 


Default translation agent: <trkclli> <trkmem> 
Default bearer capability: <BC name> 


Meaning: This message is a list of all selections in response to the selected query 
command. If the select query is issued in a TERMRES testbook or 
outside of a testbook, only the default translation agent and the bearer 
capability are displayed. 


Action: None 


Present default translation agent is <clli> <member> <BC name>. 
Do you want to replace it with <clli> <member> <BC name>? 


Meaning: This prompt is the response to the select defintrk command with a 
parameter when a default value already exists. 


Action: Respond with y to confirm or n to abort the command. 


297-1001-821 Standard 04.01 June 1999 


DCTLTP level commands D-181 
select (continued) 


Responses for the select command (continued) 


MAP output Meaning and action 


Default translation agent <clli> <member> <BC name< SELECTed. 
It is the default for all testbooks. 


Meaning: This is the response when a select defintrk command is confirmed and 
validated successfully. 


Action: None 
No test book is active. 
Meaning: This is the response to a select command when there is no active 
testbook. The default translation agent applies to all testbooks while all 


other sections apply only to active testbooks. 


Action: Access a testbook and try again. 


SELECTions are disallowed from TERMRES testbooks. 


Meaning: Select has been attempted from within testbook TERMRESO or 
TERMRES1. 


Action: Activate an originating testbook, and reissue the select command. 
Incoming trunk <clli> <mem> SELECTed for translation. 


Meaning: This is the response to a successfully selected and valid incoming trunk 
and member for pretranslation. 


Action: None 
Incoming trunk <clli> <mem> is invalid. 
Meaning: The selected incoming trunk, member, or both are not datafilled. 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 


Originating DN <dn> SELECTed for translation. 


Meaning: This is the response to a successfully selected and valid originating DN 
of a DU for pretranslation. 


Action: None 
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Responses for the select command (continued) 
MAP output Meaning and action 
Originating DN <dn> is invalid. 
Meaning: The selected originating DN is not datafilled. 


Action: Check tables DNINV and KSETLINE. 


Bearer capability <BC name> is also SELECTed. 


Meaning: This message is displayed upon successful selection of an agent for 
translation. 


Action: None 


Bearer capability <BC name> is invalid. 
56KDATA is used instead. 


Meaning: This message is not currently used. It is displayed only when the 
MAPCL is in severe difficulty. 


Action: None 


Trunk group <clli> is not an incoming or 2-way trunk. 


Meaning: The incoming trunk being selected is not capable of supporting incoming 
traffic. 


Action: Check the trunk direction in tables TRKGRP and TRKSGRP. 


Trunk group <clli> is not an outgoing nor 2-way trunk. 


Meaning: The incoming trunk being selected is not capable of supporting outgoing 
traffic. 


Action: None 
IBERT DTU <DTU mem> cannot be used by DCT. 


Meaning: The DTU being selected is datafilled in table FMRESINV, but DCT is not 
a valid user ofthe DTU. 


Action: Use the select command to select a DTU which belongs to DCT class, 
or change the datafill in table FMRESINV, 
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Responses for the select command (continued) 


MAP output Meaning and action 


IBERT ILC LEN <ILC len> cannot be used by DCT. 


Meaning: The DTU being selected is datafilled in table FMRESINV, but DCT is not 
a valid user of that DTU. 


Action: Use the select command to select an ILCk which belongs to DCT class, 
or change the datafill in table FMRESINV, 


Outgoing trunk and IBERT SELECTions have been CLEARed. 


Meaning: This message confirms the resetting of the outgoing selections as well 
as IBERT selections. 


Action: None 
All SELECTions have been CLEARed. 


Meaning: This message confirms the resetting of all selections previously made, 
excluding the default translation agent. 


Action: None 
Incoming trunk <clli> <mem> is not supported. 


Meaning: The selected incoming trunk, member, or both are datafilled but are not 
trunk types that DCT supports. 


Action: None 
LENs are not supported in Toll Offices. 
Meaning: The user has attempted to select a DN for emulation. DNs and their 
basis, LENs, do not exist in toll offices. This message also appears 


when the user issues the select | command while in a toll office. 


Use an incoming trunk as originating agent; that is, select intrk or 
defintrk, and the DTU as test head; that is, select dtu or ibert. 


Unable to SELECT Posted Item. 


Meaning: There has been an abnormal error while attempting to execute the select 
posted command; that is, select with no parameters. 


Action: Post the item, and try the select command again. 
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select (end) 


Responses for 
MAP output 


the select command (continued) 


Meaning and action 


SELECT command failed. Try again 
Report swerr to the next level of support. 


Meaning: There has been an abnormal error while attempting the select 
command. The conditions that caused the failure are sometimes 
transient, so the user is asked to try again. 


Action: Report any SWERRS. 


IBERT <n> does not exist 


Meaning: This message is displayed when the selected IBERT <n> is not 
datafilled in table FMRESINV. 


Action: Check table FMRESINV, and datafill IBERT <n>. 


IBERT <n> cannot be used by DCT. 


Meaning: The IBERT <n> is datafilled in table FMRESINV but not for DCT 
application class. 


Action: Use the select command to select an IBERT which belongs to DCT 
class, or change the datafill in table FMRESINV. 


IBERT <n> is SELECTed. 


Meaning: IBERT has been successfully selected. 


Action: None 


Outgoing trunk <clli> is not supported. 


Meaning: The selected outgoing trunk, member, or both are datafilled but are not 
trunk types the DCT supports. 


Action: In table TRKGRP ensure that the field GRPTYPE is IBNTO, IBNT2, IT, 
T2, TO, OR OC. 
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Function 


Use the stop command to terminate the current test call and all remaining 
test calls in the dial sequence in the active testbook immediately. 


stop command parameters and variables 


Command Parameters and variables 


There are no parameters or variables 


Qualifications 


The stop command is qualified by the following exceptions, restrictions, and 
limitations: 


e The stop command is only valid if a testbook is active. 


e The stop command applies only to the current test of the active testbook. 
If no dial command is currently executing, the command is ignored. 


e The stop command cannot be executed from TERMRES testbooks. 
Example 


The following table provides an example of the stop command. 


Examples of the stop command 


Example Task, response, and explanation 


Task: Stop current and remaining tests in current dial sequence. 


Response: STOP command completed. 
DIAL command in testbook mt111 is being STOPped. 


Explanation: The stop command has successfully executed. 
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Responses 


The following table provides explanations of the responses to the stop 
command. 


Responses for the stop command 
MAP output Meaning and action 
STOP command not executed. 


Meaning: The general message is displayed when the stop command is not 
successfully executed. 


Action: None 


No testbook is active 


Meaning: No testbook is active when the stop command is entered. The stop 
command is only valid when a testbook is active. 


Action: None 


No DIAL command is executing. 


Meaning: No dial command is executing in the active testbook when the stop 
command is entered. 


Action: None 


DIAL command in testbook <ID> is being STOPped. 


Meaning: The general message is displayed when the stop command is 
successfully executed. 


Action: None 


A TERMRES testbook is active. 


Meaning: A TERMRES testbook is the active testbook when the stop command is 
entered. Tests in the TERMRES testbooks cannot be stopped. 


Action: Access the originating testbook, and try again. 
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Responses for the stop command (continued) 
MAP output Meaning and action 
DCT is unavailable. System maintenance in progress. 
Meaning: The DCT process is temporarily unavailable due to the process dying or 
system maintenance. The DCT process will restart itself; then, the full 
set of DCT commands will be available. 


Action: None 


STOP command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The stop command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. ASWERR is also generated. 


Action: Report SWERR, and try again. 
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testbook 


Function 
Use the testbook command to do the following: 


e access a testbook 

e create a new testbook 

e display information on the active testbook 

e count the number of testbooks 

e lista specified number of testbook IDs from the list of testbook IDs 


e move the list index up or down a specified number of items in the list of 
testbook IDs 


testbook command parameters and variables 


Command Parameters and variables 


testbook active 
count 


down one 
up offset 


list three 
quantity 


point all 
position 
query tstbk_id 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that information on the 
active testbook is displayed because the testbook command is issued with no 
parameters. 


This parameter displays all testbook IDs in the list of testbooks. The index is moved 
to the bottom of the list. 


This parameter displays the number of testbooks that have been created. 


This parameter moves the index down (the number of items indicated by the offse 
variable) in the list of testbooks. The active test book is not affected. 


This parameter displays consecutive testbook IDs from the list of testbooks, starting 
at the current index position for as many testbooks as are indicated by the quantit 
variable. The index is moved down 3 positions. The active testbook is not affectef. 
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testbook (continued) 


testbook command parameters and variables (continued) 


Parameters 
and variables 


tstbk_id 


Description 


The variable indicates the number of positions up or down to move the index and 
has a range of 1-256. 


This default parameter, which is never entered, indicates that the index will be 
moved up or down one position when no value for the offset variable is entered. 


This parameter points to the testbook ID at the position in the list of testbooks 
indicated by the position variable. This list is kept by the DCT tool and is in 
chronological order. This command does not affect the active testbook. 


This variable indicates the number of positions down from the first position to poin 
the index and has a range of 1-256. 


This variable indicates the number of testbook IDs to list and has a range of 1-256 
This parameter provides brief information on testbooks. 


This default parameter, which is never entered, indicates that three testbook IDs 
be listed when no value is entered for the quantity variable. 


This variable identifies the testbook that will be active, if it exists. If not, the user 
is prompted to create it. The variable may be replaced with any 1-8 character 
alphanumeric string, except for the following reserved keywords: 


count 
up 
down 
list 
point 


This parameter moves the index up (the number of items indicated by the offset 
variable) in the list of testbooks. The active test book is not affected. 
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Qualifications 


The testbook command is qualified by the following exceptions, restrictions, 
and limitations: 


e The testbook command prompts the user for confirmation before 
creating a new testbook to avoid crating new testbooks accidentally. 


e Real-time error display, requested by the display on command, is 
stopped when a new active testbook is entered; that is, the command 
testbook tstbk_id stops any previously requested real-time error display 
unless the tstbk_id is the ID of the currently active testbook. 


Examples 
The following table provides examples of the testbook command. 


Examples of the testbook command 


Example Task, response, and explanation 
testbook . 


Task: Determine the active testbook 


Response: 
Active testbook bcs35ck 
Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go by 


100 1011 1012 11 Testing JeanP 


Explanation: The active testbook and brief summary of contents are displayed. 
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testbook (continued) 


Examples of the testbook command (continued) 


Example Task, response, and explanation 


testbook xb25 J 
where 


xb25 is the ID of the testbook 


Task: Obtain brief summary of information on testbook xb25 


Response: 
TESTBOOK sb25 is now active. 
Active testbook xb25 
Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go 


25 50 51 200 Testing 


Explanation: A brief summary of the contents of xb25 is displayed. 


testbook liem . 
where 


liem is the ID of a new testbook to be created 
Task: Create new testbook liem. 
Response: Do you wish to create a testbook Liem? 
>y.J 


Test book Liem is now active. 


Explanation: The new testbook liem is created and is active. 
testbook count — 


Task: Determine how many testbooks there are. 


Response: Number of testbooks is 126 


Explanation: The number of testbooks is counted and displayed. 
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testbook (continued) 


Examples of the testbook command (continued) 


Example Task, response, and explanation 


testbook 300 — 
where 


300 is the number of positions the index is to move down form the top 


Task: Point index to ID of testbook 300 positions from the top of the list. 
Pointing to testbook prob512 

Number Last Created 
of tests used by 


Response: 
Testbook Number 
ID of users 


prob512 3 93 1993/03/09 11:24:42 HAIN 


Explanation: prob512 is the ID of testbook 300 positions from the top. 


testbook list all . 
Task: List all of the testbooks. 
Response: 


Testbook Number 
ID of users 


Last Created 
used by 


Number 
of tests 


TERMRESO 


TERMRES 
Z1 

Z2 
Homerl 
Homer2 
Number 
Bottom 


Explanation: 


1 


5 
5 
1 
3 
al 


4 
of testbooks listed: 
of testbook list. 


All testbooks are listed. 


1993/03/09 
1993/03/09 
1993/03/10 
1993/03/10 
1993/03/15 
1993/03/15 


6. 


DCT 

DCT 
ZEGRAY 
ZEGRAY 
HOMAYOON 
HOMAYOON 
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Responses 
The following table provides explanations of the responses to the testbook 


command. 


Responses for the testbook command 
MAP output Meaning and action 
Testbook <ID> is now active. 
Meaning: This message confirms that the testbook is now active. 


Action: None 


No testbook is active. 


Meaning: This message appears when the testbook command with no parameters 
or with query keyword is issued before setting an active testbook. 


Action: Access a testbook, and try the command again. 


Do you wish to create testbook <ID>? 


Meaning: The message prompts the user to confirm creating a new testbook ID 
before proceeding. 


Action: Respond with a y to confirm testbook creation or with an n to reject 
testbook creation. 


TESTBOOK command not executed. 
Meaning: This is a general message displayed when the testbook command is not 
successful, for example, when the user replies with no to the prompt for 
creating a testbook or an invalid option or keyword is entered. 


Action: None 


Number of testbooks listed : <n> 


Meaning: This message displays the number of testbooks listed, as requested by 
the testbook list command, where <n> is the number of testbooks. 


Action: None 
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testbook (continued) 
Responses for the testbook command (continued) 


MAP output Meaning and action 


Number of testbooks is <n> 


Meaning: This message displays the number of testbooks as requested by the 


testbook count or query command, where <n> is the number of 
testbooks. 


Action: None 
Top of testbook list 
Meaning: This message is displayed whenever the index to the list of testbooks is 


taken to the top of the list by a testbook point or testbook up command. 
Action: None 


Bottom of testbook list 


Meaning: This message is displayed whenever the index to the list of testbooks is 


taken to the bottom of the list by a testbook point, testbook down, or 
testbook list command. 


Action: None 


Pointing to testbook <ID>. 


Meaning: This message is part of the acknowledgement of testbook point, 
testbook up, or testbook down. It displays the testbook ID at the 
resulting position. 


Action: None 


Continuous DISPLAY OFF for previous testbook <ID>. 


Meaning: This message informs the user that the display on command issued from 


the previous testbook has stopped when the testbook <ID> was issued. 
Refer to the display command. 


Action: None 


Active testbook <ID> 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters or with query keyword. 


Action: None 
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Responses for the testbook command (continued) 


MAP output Meaning and action 


Testbook Number Number Last Created 
ID of users of tests used by 


<number> <number> <date/time> <user_ID> 
<number> <number> <date/time> <user_ID> 


<number> <number> <date/time> <user_ID> 


Meaning: This message is the response to the testbook list command. It displays 
a list of testbook IDs, where: 


<ID> is the testbook identification 

<number> is the number of users or number of tests 
<date/time> is the date and time last used 

<user_ID> is the identification of the user who created the 


testbook 
Action: None 


There are no testbooks 


Meaning: This message is the responce to the command testbook up, testbook 
down, testbook list, or testbook point when there are no testbooks. 
Because testbooks TERMRESO and TERMRESI1 are always present, 
this response should not appear under normal conditions, but can 
appear if TERMRES testbooks were not created and no originating 
testbooks have been created yet. 


Action: Try the command again, and report this error to the next level of support. 


DCT Office parameters are being changed. Try again later. 


Meaning: This message responds to a testbook being selected when DCT Office 
parameters are being changed. This is because changing the OFENG 
parameter DCT_MEM_LIMIT may cause the testbook memory structure 
to be affected. No testbooks should be accessed while 
DCT_MEM_LIMIT is being changed. 


Action: Wait, and try again later. 
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Responses for the testbook command (continued) 
MAP output Meaning and action 
Testbook list is busy. Try again later. 


Meaning: This message is the response to an attempts to execute testbook 
commands at more than one MAP at a time. 


Action: Wait a few moments, then try again. 


There is no memory available to create a testbook. 


Meaning: An attempt to create a testbook has occurred when no more memory 
resources have been allocated to the DCT. 


Action: The user should delete unneeded test results and testbooks, and try 
again. 


There is a maximum of 256 testbooks. 


Meaning: This message is the response to an attempt to create a new testbook 
when the maximum of 256 testbooks, including TERMRESO and 
TERMRESI1, have already been created. 


Action: The user should delete unneeded testbooks using the delete command. 


Severe error condition. Cannot create or delete testbooks. 


Meaning: This message is the response to an attempt by the user to create or 
delete a testbook when certain resources are unavailable. This is 
usually associated with the repeated failure of the test call DCT 
processing software. In this case, only existing test results can be 
displayed or dumped to other media, and no test calls will be possible. 


Action: Try again, and if the same message appears, report this error condition. 
Test results should be dumped to other media in case of corruption of 
results. 


TESTBOOK LIST index is unpositioned. 
Use TESTBOOK POINT command to reposition. 


Meaning: This message is the response to testbook up, testbook down or testbook 
list when the testbook preciously indexed has been deleted. The index 
is unpositioned and must be repositioned. 


User should reposition the list index using the testbook point command. 
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Responses for the testbook command (continued) 


MAP output Meaning and action 


Active testbook bcs35ck 

Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go by 


<number> <number> <number> <number> <user_ID> 
or NONE or NONE or NONE 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters, or activating an existing testbook, 
where: 


<number> is the number of tst results, last test performed, 
current test number or number of tests to go. 

<user_ID> is the identification of the one who created the 
testbook. 


and where (*) is one of the following: 


none 
call setup 
testing 
inter-call delay 
paused 
delayed start 
- trial call 
Action: None 


Number of test results: <n>. Last test performed: <m>. 
Current test numbers: 
<list of current test call numbers> or NONE. 


Meaning: This message is part of normal response to the testbook command 
when issued with no parameters in, or activating terminating testbooks. 
It displays the total number of tests, the test numbers of the currently 
running tests in the terminating testbook (TERMRESO or TERMRES1). 


Action: None 
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Responses for the testbook command (continued) 


MAP output Meaning and action 


This testbook is being used for incoming tst call results. 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters in, or activating terminating testbooks. 
It is displayed when currently running terminating tests are stored in the 
currently active terminating testbook (TERMRESO or TERMRES1). 
Note that only one terminating testbook can be used for incoming calls 
at a time, and will thus have this response. 


Action: None 
Testbook <ID> is the active testbook. 


Meaning: This message is the response to the testbook <ID> when that testbook 
is already the active one. In this case the only result of the user’s 
command will be to display this message. 


Action: None 


TESTBOOK commnd failed. Try again. 
Report swerr to the next level of support 


Meaning: This message is in response to an unknown internal software error. The 
system will generate a SWERR report. 


Action: 


Try again later. If the condition persists check and report any SWERRS 
generated. 
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DCTTTP level commands 


Use the DCTTTP level of the MAP to access the data call tester (DCT) 
menu commands. 


Accessing the DCTTTP level 
To access the DCTTTP level, enter the following from the CI level: 
mapci;mtc;trks;ttp;dctttp | 


DCTTTP commands 


The commands available at the DCTTTP MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DCTTTP commands 


Command 


deftime 
delete 
dial 
display 
hold 
inject 
next 


post 


quit 


release 


select 
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DCTTTP commands (continued) 


Command 


stop DCTTTP 
testbook 


DCTTTP menu 
The following figure shows the DCTTTP menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 


J 


ONSISUPWDNDHODVDOTSNSIAUPWN ON 
[ral 


POST DELO BUSYO DIG 
Quit TIP 6-037 
Post_ CKT TYPE PM NO. COM LANG STA S R DOT TE RESULT 


Testbook 
Dial_ 
Inject_ 
Display_ 
Delete_ 


Hold 
Next_ 


Select _ 
DefTime_ 


hp 


Stop 
Release 


hp 


297-1001-821 Standard 04.01 June 1999 


DCTTTP level commands D-203 
deftime 


Function 
Use the deftime command to perform the following functions: 
e set the test duration of 
- all subsequent dial commands issued in the same MAP session 


- all test calls initiated by the dial command currently executing in the 
active testbook 


- the test call currently executing in the active testbook 


e set the start time to be applied to the next dial command issued in the 
same MAP session 


e set the wait time on busy trunks 

e set the delay time in between test calls 

e reset test duration, start time, busywait, or delay to default times 
e query the deftime settings 


deftime command parameters and variables 


Command Parameters and variables 


deftime | busywait | resetdef 

<com> sec bsy_sec 
min bsy_min 
hour bsy_hour 
resetdef 
sec del_sec 
min del_min 
hour del_hour 

duration resetdef 
sec dur_sec 
min dur_min 
hour dur_hour 
day dur_day 


reset 
ddd hh 


Parameters 
and variables Description 


busywait This parameter sets the wait time on busy trunks to the time specified by the 
bsy_hour, bsy_min, or bsy_sec variable or to the default time of 120 sec when no 
variable is entered. 
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deftime command parameters and variables (continued) 


Parameters 
and variables 


bsy_hour 


bsy_min 


bsy_sec 


day 


ddd 


delay 


del hour 


del_min 


del_sec 


duration 


dur_day 


dur_hour 


dur_min 


dur_sec 


Description 


This variable is the number of hours to which busywait is to be set to and has a range 
of 0-1. 


This variable is the number of minutes to which busywait is to be set to and has a 
range of 0-60. 


This variable is the number of seconds to which busywait is to be set to and has a 
range of 0-3200. 


This parameter indicates that the number of days of duration is to be specified and 
must be followed by the dur_day variable. 


This variable is the day of the week to which the start time is to be set and may take 
one of the values mon, tue, wed, thu, fri, sat, or sun. 


This parameter sets the delay time between test calls to the time specified by the 
del hour, del_min, or del_sec variable or to the default time of 5 min when no 
variable is entered. 


This variable is the number of hours to which delay is to be set and has a range of 
0-3. 


This variable is the number of minutes to which delay is to be set and has a range 
of 0-180. 


This variable is the number of seconds to which delay is to be set and has a range 
of 0-10800. 


This parameter sets the test duration to the time specified by the dur_hour, dur_mih, 
or dur_sec variable or to the default time of 900 sec when no variable is entered. 


This variable is the number of days to which the duration is to be set and has a rarlge 
of 0-3. 


This variable is the number of hours to which the duration is to be set and has a 
range of 0-72. 


This variable is the number of minutes to which the duration is to be set and has a 
range of 0-4320. 


This variable is the number of seconds to which the duration is to be set and has 
a range of 0-259200. 


This variable is the hour of the day to which the start time is to be set and has a rahge 
of 0-23. 
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deftime command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter indicates that the number of hours of busywait, delay, or duration 
is to be specified and must be followed by the appropriate variable. 


This parameter indicates that the number of minutes of busywait, delay, or duratio 
is to be specified and must be followed by the appropriate variable. 


This variable is the minute of the hour to which the start time is to be set and has 
a range of 0-59. 


This parameter displays all the current deftime settings. 
This parameter resets the start time to now when it follows the start parameter. 
This default parameter, which is never entered, indicates that the default value of 


900 sec for duration, O sec for delay, or 120 sec for busywait will be set because 
no time-parameter-variable combination is entered. 


This parameter indicates that the number of seconds of busywait, delay, or duratiqn 
is to be specified and must be followed by the appropriate variable. 


This parameter sets the test start time specified by the ddd, hh, and mm variables 
or resets the start time to the default value of now if the reset parameter is entered. 


Qualifications 
The deftime command is qualified by the following exceptions, restrictions, 
and limitations: 


e The default values set by the deftime command apply to the current map 
session only. They are lost when the MAP is exited and entered again. 


e The deftime command can be issued if no testbook is active. 


e If a testbook is active, the deftime duration command also applies to the 
current test call and dial command of the active testbook, even 1f 
delayed. However, this does not apply to TERMRES testbooks. 


e When a start time is applied to a dial command, the start time is reset to 
now and must be set again if needed for another dial command. 


e If a start time has been set, the dial command prompts the user to 
confirm it before proceeding. 


e The busywait time is the time to wait on a busy trunk for a DCT test call 
before giving up. The busywait value applies to all dial commands that 
are issued from the same MAP session. 
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Examples 
The following table provides examples of the deftime command. 


Examples of the deftime command 


Example Task, response, and explanation 


deftime duration min 10 — 
where 


10 is the number of minutes to which duration is to be set 


Task: Define the time for test duration for 10 min. 
Response: DEFTIME DURATION command completed. 
DURATION set to 600 seconds. 
No testbook is active. 
Explanation: The test duration time is set to ten min (600 sec). The command 


did not affect any current test or dial command since no testbook 
was active. 


deftime busywait sec 1200 J 
where 


1200 is the number of seconds to which to which busywait is to be set 
Task: Define the busywait time as 1200 sec. 


Response: DEFTIME BUSYWAIT command completed. 
BUSYWAIT is set to 1200sec. 


Explanation: The command successfully set busywait to 1200 sec. 


deftime delay — 


Task: Reset delay time to default value. 


Response: DEFTIME DELAY command completed 
DELAY is set to Osec 


Explanation: The delay time is set to the default time of 0 sec. 
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Examples of the deftime command (continued) 


Example Task, response, and explanation 


deftime start mon 20 30 — 
where 


20 Is the hour of the day to which start is to be set 
30 is the minute of the hour to which start is to be set 


Task: Set start to 8:30 pm, Monday. 


Response: DEFTIME START command completed. 
START time is set at MON 20:30:00. 


Explanation: The start is successfully set to 8:30 pm, Monday. 
deftime query .| 
Task: Determine current deftime settings 
Response: Current DEFTIME settings: 
DURATION START DELAY BUSYWAIT 


100 NOW 0 120 


Explanation: All values are currently set to default values except duration. All 
values are in seconds. 


Responses 


The following table provides explanations of the responses to the deftime 
command. 


Responses for the deftime command 


MAP output Meaning and action 


DEFTIME DURATION command completed. 
DEFTIME BUSYWAIT command completed. 
DEFTIME DELAY command completed. 
DEFTIME START command completed. 


Meaning: These general messages are displayed when the deftime command is 
successfully executed. 


Action: None 
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Responses for the deftime command (continued) 
MAP output Meaning and action 
DURATION is set to <time>seconds. 


Meaning: The deftime duration command has set time to new value of <time>. All 
subsequent dial commands will have this time for their test duration. 


Action: None 
DURATION is still set to <time> seconds for this MAP. 
Meaning: The deftime duration cannot be confirmed due to an internal error. 
However, the duration to be applied for the next dial in this MAP session 
is still set. Also, a SWERR is generated. 


Action: Report the SWERR and try again later. 


DURATION applies to remaining calls of current DIAL command. 


Meaning: A dial command is executing when the deftime duration command is 


issued. The new duration is going to be applied to the remaining test 
calls in the current dial command. 


Action: None 


DURATION applies to current test call. 
Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is going to be applied to the current dial 
command. 


Action: None 


DURATION applies to current and remaining calls of DIAL command. 
Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is going to be applied to the call in progress 
and the remaining test calls to be made. 


None 


297-1001-821 Standard 04.01 June 1999 


DCTTTP level commands D-209 
deftime (continued) 


Responses for the deftime command (continued) 


MAP output Meaning and action 


DURATION is too short for current test call. 


Meaning: A dial command is executing when the deftime duration command is 
issued. The new duration is not going to be applied to the call in 
progress because the elapsed time for the current call is already greater 
then the duration specified. However, the new duration will be applied to 
the remaining test calls of the current dial command. 


Action: None 


There are no remaining calls to apply DURATION to. 


Meaning: A dial command is executing when the deftime duration command is 
issued. The command was issued during the delay between calls. 


Action: None 


BUSYWAIT is set to <time> seconds. 


Meaning: The deftime busywait command successfully executed. 


Action: None 


DELAY is set to <time> seconds. 
Meaning: The deftime delay command successfully executed. 


Action: None 


START time is set at <{ddd hh:mm} or NOW>. 
Meaning: The deftime start command successfully executed. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the deftime duration command is issued. No 
current test or dial command is going to be affected by the command. 


Action: None 
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deftime (continued) 


Responses for the deftime command (continued) 
MAP output Meaning and action 
No DIAL command is executing. 
Meaning: No dial command is executing in the active testbook when the deftime 
duration command is entered. No dial command currently executing is 


affected by the command. 


Action: None 


No test call is running. 


Meaning: No test call is running at the time the deftime duration command is 
entered. No test currently running is affected by the command. 


Action: None 


A TERMRES testbook is active 


Meaning: A TERMRES testbook is active at the time the deftime duration 
command is issued. No test currently running in the TERMRES 
testbook is going to be affected by the command since duration of 
current tests in TERMRES testbooks cannot be modified by this 
command. 


Action: Access an originating testbook and try again 


Current DEFTIME settings: 
DURATION START DELAY BUSYWAIT 
<n> <day time> <n> <n> 

or NOW 


Meaning: This response to the deftime query command shows all current time 
settings. All times are in seconds. 


Action: None 


DURATION applies to all test calls of delayed DIAL. 


Meaning: A deftime duration command is executed while the current dial 
command is set to start sometime in the future. 


Action: None 
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Responses for the deftime command (continued) 
MAP output Meaning and action 
DCT is unavailable. System maintenance in progress. 


Meaning: The DCT process is temporarily unavailable due to system maintenance 
such as a PRESWACT. 


Action: Try again later 


DEFTIME command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The deftime command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. 


Action: None 
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Function 


Use the delete command to delete all or a subset of the test results belonging 
to the active testbook or to delete test results with no errors within a 
specified test range only. 


delete command parameters and variables 


Command Parameters and variables 


nolist norange 
Ist num to last_num 


list 
testbook 


Parameters 
and variables Description 


This parameter selects all tests in the active testbook for deletion. 


This parameter indicates that a list or range of test numbers, or both, is to be 
indicated. A list may be followed by a range which may be followed by an additio 
list of test numbers. The to parameter between test numbers distinguishes 
between a range and a list. 


This default parameter, which is never entered, indicates that all test results 
selected, with or without errors, will be deleted. 


This default parameter, which is never entered, indicates there is no list of test 
numbers. If the parameter t is used, there must be either a list or range of test 
numbers, or both, following it. 


This variable is a list of test numbers. The list may contain up to a maximum of 1( 
test numbers, each separated by a space. dst numbers may be any number in the 
range of 1-65535. 


This default parameter, which is never entered, indicates there is no range of test 
numbers. If the parameter t is used, there must be either a list or range of test 
numbers, or both, following it. 


1st_num This variable is the first test number in a range of test numbers. 


to This parameter must be used between the 7st_num and last_num variables of a 
range of test numbers. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-214 DCTTTP level commands 
delete (continued) 


delete command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is the last test number in a range of test numbers. 


This parameter selects only test results with no errors, for the specified test 
numbers, to be deleted. 


Qualifications 
The delete command is qualified by the following exceptions, restrictions, 
and limitations: 


e The maximum number of individual test numbers allowed in a delete 
command is 10. 


e A testbook cannot be deleted if a dial command is executing in it, if test 
results exist that belong to it, if it is active on another MAP, or if it is a 
TERMRES TESTBOOK. 


e Test numbers cannot be greater than 65 535. 
e The delete command applies to the active testbook. 
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Examples 
The following table provides examples of the delete command. 


Examples of the delete command 


Example Task, response, and explanation 


delete t 123 402 501 J 
where 


123, 402, and 501 are test numbers 
Task: Delete the test results for tests numbered 123, 402, and 501. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
3 test results DELETEd. 


Explanation: The results for the three selected tests have been deleted 


delete T 400 401 406 408 noerr — 
where 


400, 401, 406, and 408 are test numbers 


Task: Delete the test results without errors for the tests numbered 400, 
401, 406, and 408. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
2 test results DELETEd. 


Explanation: Only two test results were found to have no errors and were 
deleted. All four test results exist. 
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delete (continued) 


Examples of the delete command (continued) 


Example Task, response, and explanation 


delete test 640 to 659 J 
where 


640 and 659 are the first and last test numbers of a range 


Task: Delete the results of all tests in the range 640 
to 659. 


Response: Please confirm (y/n) 
>y 
DELETE command completed. 
20 test results deleted 


Explanation: The results of all 20 tests in the range have been deleted. 
delete testbook — 


Task: Delete the active testbook. 


Response: Please confirm (y/n) 
>y 
DELETE command not executed. 
Testbook HOMER1 contains test results. 


Explanation: The active testbook cannot be deleted because it contains test 
results. 


Responses 


The following table provides explanations of the responses to the delete 
command. 


Responses for the delete command 


MAP output Meaning and action 


DELETE command not executed. 


Meaning: This is a general message displayed when the delete command is not 


successfully executed, for example, when the user replies no to the 
prompt, or an invalid option is entered. 


Action: None 
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delete (continued) 


Responses for the delete command (continued) 
MAP output Meaning and action 
DELETE command completed. 


Meaning: This is a general message displayed when the delete command is 
successfully executed. 


Action: None 
<n> test results DELETEd. 


Meaning: The delete command is completed and <n> is the number of test results 
deleted. 


Action: None 
Testbook <id> contains test results. 


Meaning: The delete testbook command cannot be executed because the 
testbook, identified as <id>, contains test results. 


Action: If the testbook is to be deleted, all test results in the testbook have to be 
deleted first using the delete all command. Test results should normally 
be backed up before being deleted. 


A dial command is executing in testbook <id>. 
Meaning: The delete testbook command is issued for a testbook with no test 


results in it while a dial command is executing, therefore, the delete 
command cannot execute,. 


Action: The testbook can be deleted by aborting the dial command with the stop 
command, or deleting all test results the delete all command and then 
reissuing the command The testbook can also be deleted by waiting for 
the dial command to be completed, then deleting the test results and 
reentering the delete testbook command. 


Testbook <id> is being used by another MAP. 


Meaning: The delete testbook command is issued for a testbook identified by <id> 
which is being used by another MAP. The command cannot, therefore, 
be executed. 


Action: Take no action or wait until no one is using the testbook and reissue the 
command. 
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Responses for the delete command (continued) 
MAP output Meaning and action 
Testbook <id> DELETEd. 


Meaning: This message is displayed if the delete testbook command was 
successful in deleting the active testbook. 


Action: None 


No Testbook is active. 


Meaning: The delete testbook command is issued when there is no testbook active 
and cannot, therefore, be executed. 


Action: None 


No test results exist in testbook <id>. 


Meaning: The delete t command was issued for a testbook without any test 
results. 


Action: None 


Test results queue is busy. 
A DELETE or DISPLAY command is being executed by another user. 
Try again later. 


Meaning: This message is the response to an attempt by the user to delete test 
results when the test results queue is being used by another user. 


Action: Wait a moment, then try again. 


TERMRES testbooks cannot be DELETEd. 


Meaning: This message is the response to an attempt to delete testbook 
TERMRESO or TERMRES1. These terminating testbooks cannot be 
deleted. 


Action: None 
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delete (end) 


Responses for the delete command (continued) 


MAP output Meaning and action 


DELETE command failed. Try again 
Report swerr to the next level of support. 


Meaning: This message is printed when an internal error is encountered. 


Action: Report any SWERRS generated. 
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Function 
Use the dial command to perform the following: 


e sequentially dial one or more NSs from table DCTDIAL, and perform 
BERT testing on each one. Options include: 


- specify a repetition factor 


- request that BERP testing be dropped for free IBERTs if none is 
available 


- request the use of preselected trunk resources, IBERT resources, or 
both 


e temporarily halt the execution of the currently executing dial command 
e resume the execution of a halted dial command 


e abort the currently executing dial command, after the current test call is 
over 


dial command parameters and variables 


Command Parameters and variables 


nolist norange norepeat 
list 1st_dn last_dn repeat 


off 
pause 
resume 


dial 


(continued) 


Parameters 
and variables Description 


This parameter indicates that a list of DN indexes, a range of DN indexes, or both 
are to be entered. 


This parameter aborts the currently executing dial command after the current test 
call is finished. 


This parameter temporarily halts the execution of the currently executing dial 
command in the active testbook. 
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dial command parameters and variables (continued) 


Parameters 
and variables 


norepeat 


repeat 


count 


Description 


This parameter resumes the execution of the dial command halted by the pause 
parameter. 


This default parameter, which is never entered, indicates that the dial command will 
not operate on a list of DN indexes because no list is entered. 


This variable is a list of DN indexes. The list may contain up to 50 indexes, each 
separated by a space. A DN index number has a range of 1-2048. 


The default parameter, which is never entered, indicates that the dial command will 
not operate on a range of DN indexes because none is specified. 


This variable is the first DN index in a range of DN indexes to be specified and has 
a range of 1-2048. 


This variable is the last DN index in a range of DN indexes to be specified and has 
a range of 1-2048. 


This parameter must be used to separated the 7st_dn variable and last_dn variable 
in a range of DN indexes. 


This default parameter, which is never entered, indicates that the DN sequence will 
not be repeated because the repeat parameter is not entered. 


This parameter causes the DN sequence to be repeated the number of times 
indicated. 


This variable indicates how many times the DN sequence is to be repeated and hds 
a range of 1-3000. 


This default parameter is the number of times the DN sequence will be repeated 
if no range is specified with the repeat parameter. 


This default parameter, which is never entered, indicates that BERP testing is not 
dropped because the i parameter is not entered. 


This parameter requests dropping BERP testing to free IBERTS if none are 
available for DCT calls. 
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dial command parameters and variables (continued) 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that no preselected trun 


or IBERT resources are used because the s parameter is not entered. 


This parameter uses the preselected trunk resources, IBERT resources, or both. 


Qualifications 


The dial command is qualified by the following exceptions, restrictions, and 
limitations: 


e The dial command cannot be issued from testbook TERMRESO or 
TERMRESI that are reserved for incoming test calls. 


e The maximum number of test calls that can be requested by a single dial 
command is limited by the amount of available unused test numbers in 
the active testbook, with an absolute maximum of 65 535. 


e The maximum number of DN indexes allowed in a single dial command 
is 50. 


e The maximum number of simultaneous dial commands that can be run is 
20. 


e There can be only one executing dial command at a time in a given 
testbook. This includes delayed dial commands. 


e The dial command applies only to the active testbook. 
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Examples 
The following table provides examples of the dial command. 


Examples of the dial command 


Example Task, response, and explanation 


dial d 2 4 5 10 repeat 100 — 
where 


2,3,5,and 10 are the DN indexes 
100 is the repeat count 


Task: Dial and run BERT testing on DN indexes 2, 4, 5, and 10, and 
repeat the sequence 100 times. 


Response: The following SELECTions are being used: 
IBERT: Not Selected 
Outgoing trunk: Not Selected 
Bearer capability: 56KDATA 
DIAL command submitted. 
First test call assigned test number 241 


Explanation: BERT testing on DN indexes 2, 4, 5, and 10, is begun. 


dial D 2 4 5 to 10 repeat 100 s 
where 


2 and 4 are the DN indexes 
5 and 10 are the fist and last DN indexes in the range 
100 is the repeat count 


Dial and run BERT testing on DN indexes 2, 4, and 5-10 inclusive, 
and repeat the sequence 100 times using preselected IBERT 
resource. 


Response: The following SELECTions are being used: 
IBERT: 127 (HOST 00 0 00 00) 
Outgoing trunk: Not Selected 
Agent for translation: ICMF 0 
Bearer Capability: 64KDATA 
DIAL command submitted. 
First test call assigned test number 453 


Explanation: Command executes successfully. 
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dial (continued) 
Responses 
The following table provides explanations of the responses to the dial 
command. 
Responses for the dial command 
MAP output Meaning and action 
command not executed. 
PAUSE command not executed. 


RESUME command not executed. 
L OFF command not executed. 


Meaning: These are general messages displayed when the dial command is not 
successfully executed, for example, when the user specifies an invalid 
input to the command and a resource, such as IBERT, is not available. 


Check dial command syntax, and reenter the command. 
No testbook is active. 


Meaning: This message is displayed when a dial command is entered while no 


testbook is active. There must be an active testbook before issuing a 
dial command. 


Use the testbook command to access a testbook, and reissue the dial 
command. 


The following DN index ins not valid: <dn_index> 


Meaning: The DN index specified in a dial command ins not found in the table 
DCTDIAL 


Action: Reissue the dial command using DN indexes that exist in table 


DCTDIAL. 
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Responses for the dial command (continued) 


MAP output Meaning and action 


Too many test calls requested. Only <test_num_left> test number left. 


Meaning: More test calls are requested than the amount of available unused test 
numbers in the active testbook. The number of test calls requested is 
equal to the number of DN indexes multiplied by the repetition factor. 
The number of test numbers available, <test_num_left>, is 65 535 less 
the number already dialed in the testbook. The test numbers are 
sequential and not reuseable. To be able to reuse the test numbers, all 


of the test results must be deleted and the test numbers will then begin 
again at 1. 


Action: Reissue the dial command using a lower repetition factor or less DN 
indexes. Alternately, delete all the test results in the active testbook, or 
activate a new one and then reissue the dial command. 


No user outgoing trunk nor IBERT is selected. 
System selections will be used. 


Meaning: The parameter s is used in the dial command, but no trunk or IBERT 
selections have been made. The user is given the option of proceeding 
with the dial command using system selected resources. 


Action: Answer with a y or n. A y allows the dial command to proceed; an n 
aborts the command. 


Make you selections and reissue the dial command. 


Meaning: The user has chosen not to proceed with a system selected trunk or 
IBERT resource having responded with an n to the prompt. 


Action: Select trunk, IBERT, or both resources and reissue the dial command 
with the s option again. 


User outgoing trunk and IBERT selections will be ignored. 
System selections will be used. 


Meaning: This message is displayed when the option s is not used in the dial 
command while the trunk, bert, or both selections have been made. The 
user is given the option of proceeding with the dial command using 
system selected resources. 


Action: Answer with a y or n. A y allows the dial command to proceed; an n 
aborts the command. 


297-1001-821 Standard 04.01 June 1999 


DCTTTP level commands D-227 
dial (continued) 


Responses for the dial command (continued) 


MAP output Meaning and action 


Reissue DIAL with the “S” option. 


Meaning: The user has chosen not to proceed with a system selected trunk or 
IBERT resource having responded with an n to the prompt. 


Action: Select trunk, IBERT, or both resources and reissue the dial command 
with the s option again. 


WARNING. Start time set at hh:mm:ss dd mm YYYY. 
Do you want this DIAL command delayed until this time? 


Meaning: The dial command is issued after a future start time is set using the 
DEFTIME START command, where: 


hh:mm:ss is the hour, minute, and second 
dd is the day of the month 
mm is the month 


-  yyyy is the year 
It prompts the user to confirm the delay before proceeding. 


Action: Answer with a y orn. A y allows the dial command to proceed using the 
future date and time; an n aborts the command. 


Delayed dial not executed. 


Meaning: An n has been entered in response to the prompt for confirmation to use 
a future start time. 


Action: None 
Test call(s) delayed until hh:mm:ss dd mm YYYY. 


Meaning: A y has been entered in response to the prompt for confirmation to use a 
future start time. 


Action: None 
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Responses for the dial command (continued) 


MAP output Meaning and action 


DIAL command failed. Try again. 
Report swerr to the next level of support. 


Meaning: This message is displayed when the internal message has timed out. 


Action: Check for dial command execution by issuing the testbook command 
without parameters. The test numbers of the current, as well as the 
number to go, should not be NONE. Ifthey are, try the dial command 
again. Ifthe same message appears again, report the problem to the 
next level of support. Report the SWERR that is generated. 


Trial call failed for DN index <DN>. 


Meaning: The DCT network tool executes one trial call for each DN immediately 
following the receptions of a delayed dial command. These trial calls are 
intended to try out all the DNs targeted by the delayed dial command 
right away and to gain some level of confidence that the dial command 
will work at its scheduled time. At the first trial call failure encountered, 
the dial command is aborted and the failed DN is displayed. Since the 
dial command is aborted at the first trial call failure, there is no 
guarantee that it will work if the command is issued again without the DN 
that failed the first time. Some other DN may fail the trial call. 


Action: Check the failed DN or use another DN and try again. Report any 
problem with a working DN. 


Too many dial commands are executing. 
Meaning: This message is displayed if a dial command is issued after the 
maximum allowable number of 20 simultaneously executing dial 


commands has been reached. 


Action: Wait for a while, then issue the dial command again or abort one of the 
executing dial commands before reissuing the new one. 


A dial command is executing 


Meaning: A dial command is issued while another is still executing in the active 
testbook. 


Action: The user can either stop or dial off the currently executing dial 
command, or go to a testbook where no dial command is executing and 
reenter the dial command. 
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Responses for the dial command (continued) 


MAP output Meaning and action 


No dial command is executing. 


Meaning: No dial command is executing in the active testbook when a dial pause, 
dial resume, or dial off command is issued. 


Action: Use the testbook command to check the dial status. 


No memory left for test results. 
DELETE some test results to free memory. 


Meaning: A dial command is issued when no free storage is left to store rest 
results. This message means that memory resources are unavailable. 


Action: Dump some test results onto hard copy or magnetic storage, then delete 
these result to free some storage before reissuing the dial command. 


The following SESLECTions are being used: 
IBERT: <n> (<C11i/LEN>) 
Outgoing trunk: <Clli & mem> 
Agent for translation:<Clli or DN> 

Bearer capability: <bearer capability> 


Meaning: This is the normal response to a dial command. With the s option, the 
user selected IBERT or outgoing trunk will be displayed. 


The agent for translation and the bearer capability are used to emulate 
the originating agent for translation purpose. If none is selected 
(SELECT ORGDN/INTRK), the default (SELECT DEFINTRK) translation 
agent is used and displayed. If an originating DN or an incoming trunk & 
member are selected, they are displayed and used instead. 


Wait for next messages. 


Dial command submitted. 


Meaning: This is the normal response when dial command is successfully 
accepted and submitted for execution. 


Action: None 
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Responses for the dial command (continued) 
MAP output Meaning and action 
First test call assigned test number <number>. 


Meaning: This message is displayed when the dial is submitted for execution and 
a summary has been allocated for the first test call. 


Action: The user should go to a different testbook and reissue the dial 
command. 


Current test call will run to completion. 
Remaining test calls halted. 


Meaning: A dial pause command is accepted and submitted for execution while a 
test call is currently executing. 


Action: None 


Remaining tst calls halted. 


Meaning: This message is displayed when a dial pause command is accepted and 
submitted for execution while no test call is currently executing. 


Action: None 


Cannot PAUSE a delayed DIAL command 


Meaning: This message is displayed when a dial pause command is issued to act 
on a delayed dial command. 


Action: None 


Resuming execution of remaining test calls. 
Meaning: A dial resume command is accepted and submitted for execution. 


Action: None 


Current test call will run to completion. 
Remaining test calls aborted 


Meaning: A dial off command is accepted and submitted for execution while a test 
call is currently executing. 


Action: None 
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Responses for the dial command (continued) 


MAP output Meaning and action 
Remaining test calls aborted. 


Meaning: A dial off command is accepted and submitted for execution, and no test 
is currently executing. 


Action: None 
Cannot dial off a delayed dial command 


Meaning: A dial off command is issued and submitted for execution on a delayed 


dial command. To abort a delayed dial command, the stop command 
must be used. 


Action: Issue a stop command to abort the delayed dial. 


Missing SELECTions for translation purposes. 
SELECT one of the following: 

- Incoming trunk or originating DN 

- Default incoming trunk 


Meaning: A dial command is attempted without making appropriate translation 
selections. After a default translation agent (incoming trunk and 
member), this message should not appear. 


Action: Use the select command to select a default translation agent, an 
incoming trunk, or originating DN and try again. 


Too many DNs requested. Maximum is 50. 


Meaning: A dial command with too many DNs in the specification is attempted. 
The total number of DNs requested must be less than or equal to 50. A 


range of 1-51, for example, would cause this message to appear if all 
the DNs in the range were datafilled. 


Action: Submit the dial command again with fewer DNs specified. 
The dial sequence is not PAUSEd. 


Meaning: A dial resume command is issued when there is not an active dial 
sequence that has been paused. 


Action: None 
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Responses for the dial command (continued) 
MAP output Meaning and action 
Testing DN index: <DN>. Please wait. 


Meaning: A delayed dial command is issued. Trial calls proceed and the message 
appears for each DN index that is called. 


Action: None 


Trial call successful for DN index: <DN>. 


Meaning: A delayed dial command is issued. Trial calls proceed and this message 
appears for each successful DN index. 


Action: None 
Current tst call is the last one in the current dial command. 

Meaning: A dial pause or dial off command is issued, and only one test call 
remains in the dial sequence. The only result of tne command will be this 
message because the dial pause and commands apply to remaining test 
calls, not the currently running one. 

Action: Issue stop command to abort last test call in the dial command. 


No IBERT available. 


Meaning: A dial command is issued, and no IBERTs are available to make the test 
calls. 


Action: Check the IBERT involved in this test call and inspect the datafill in table 
FMRESUSE and FMRESINV to see that the IBERT is properly datafilled. 


DCT is unavailable. System maintenance in progress. 


Meaning: A dial command is issued when DCT processing software is unavailable 
to handle dial command requests due to system maintenance. 


Action: Wait, and try again. 
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Function 
Use the display command to perform the following: 


e display current selections and settings for trunk, IBERT, duration, 
busywait, and delay 

e isplay the test results of a particular test in the active testbook and 
optionally choose to display only test summaries 

e display test results as they occur (real-time) for the current and 
subsequent tests in an active originating testbook, or one of the current 
tests for TERMRES testbooks 


e stop the display of real-time errors 


display command parameters and variables 


Command Parameters and variables 


display current 
off 
on 
t tst_num nosumm 
summ 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that current selections 
and settings will be displayed because no parameter is entered with the command 


This parameter deactivates continuous display mode. Real-time error display for 
currently running test will stop. 


This default parameter, which is never entered, indicates that a summary of test 
results will not be displayed because the summ parameter is not entered. 


This parameter activates continuous display mode. Errors are displayed as they 
occur for all subsequent tests. In TERMRESO or TERMRES1 this parameter has 
to be followed by a test number, tst_num variable, because display must be 
requested for one test at a time. 


This parameter causes a summary of test results for the selected tests to be 
displayed. 


Menu Commands Reference Manual-DATA Through DTC! 
Volume 3 of 10 BCS36 and up 


D-234 DCTTTP level commands 
display (continued) 


display command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter indicates that a test number for results display is to be indicated b 
the tst_num variable that must follow it. 


tst_num This variable is the number of a test for which results are to be displayed. This 
variable must follow the t parameter and the on parameter if working in the 
TERMRESO or TERMRES1 testbook. The tst_num variable has a range of 
1-65 535. 


Qualifications 


The display command is qualified by the following exceptions, restrictions, 
and limitations: 


e The difference between this command and the nonmenu version of the 
display command at the DCTTOOL level is that only one summary can 
be displayed and only the option summ is recognized in menu command. 


e The display command with the test number on and off parameters 
applies only to the active testbook. If no testbook is active, the 
command is ignored. Only the display command with no parameters can 
be issued if no testbook is active. 


e The display command is ignored if a delete command is being executed 
in the same testbook by any DCT MAP. The test result queue (one for 
each testbook) is unavailable for reading when a delete command is 
acting on it. 


e Real-time error cannot be displayed on two different MAPS for the same 
test; that is, if a display on command is currently executing on one MAP 
for testbook<id>, it is ignored if issued from another MAP for the same 
testbook <id>. 


e The display on command is automatically stopped if the active testbook 
is changed. 
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Examples 
The following table provides examples of the display command. 


Examples of the display command 


Examples Task, response, and explanation 
display . 


Task: Display current selections and settings: 


Response: 
Current SELECTions and settings: 
Outgoing Trunk: OGMF 2 
IBERT: 2 (HOST 00 0 00 00) 
Agent for translation: Default translation agent 
Bearer capability: 56KDATA 
Default translation agent: ISUPICIT 0 
Default bearer capability: 64KDATA 
Duration: 900 
Busywait: 120 
Delay: 10 
Start time: NOW 


Explanation: Current selections and settings are displayed when no parameters 
are entered with the display command. 


display on J 


Task: Activate continuous display mode. 


Response: DISPLAY command completed. 
Continuous DISPLAY is ON. 


Explanation: Continuous display mode is activated. 
display off — 
Task: Deactivate the continuous display mode. 


Response: DISPLAY command completed. 
Continuous DISPLAY is OFF. 


Explanation: Continuous display mode is deactivated. 
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Responses 


The following table provides explanations of the responses to the display 
command. 


Responses for the display command 


MAP output Meaning and action 


DISPLAY command completed. 


Meaning: This is the general message displayed when the DISPLAY command is 
successfully executed. 


Action: None 


DISPLAY command not executed. 


Meaning: This is the general message displayed when the DISPLAY command is 
not successfully executed. It is always followed by additional 
explanation. 


Action: None 


Current SELECTions and settings: 

Outgoing Trunk: <CLLI/member> 

IBERT: <n> (<ILC LEN>/<DTU mem>) 
Agent for translation: <DN/CLLI & mem> 
Bearer capability: <BC name> 

Default translation agent: <DN/CLLI & mem> 
Default bearer capability: <BC name> 

Duration: <# seconds> 
Busywait: <# seconds> 

Delay: <# seconds> 

Start time: <ddd hh:mm> or <now> 


Meaning: This message is the response to the display command with no 
parameters. It is a list of all selections and settings that have been 
made earlier. 


If any of the selections have not yet been made, “Not Selected,” is 
displayed instead of the selection. 


Action: None 
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Responses for the display command (continued) 


MAP output Meaning and action 


No testbook is active 


Meaning: No testbook is active when the display command with parameters is 
issued. If no testbook is active, no test results can be displayed and no 
real-time display can be initiated or stopped. 


Action: None 


DELETE command executing. Try again alter. 


Meaning: The user tries to display test results while a delete operation is being 
performed by another user in the same testbook. 


Action: Try again later. 


No test results in testbook <id>. 
Meaning: No test results exist in the active test book. 


Action: None 


Testbook ID: <id> Test number: <number> 
Peer test number: <number> 

Call duration: <number> DN: <dialed DN> 
Start time: <dd month hh mm ss> Stop time: <dd month hh mm ss> 
IBERT: <n> (<ILC LEN>) Peer IBERT: <n> (<ILC LEN>) 
Errors <n> Errored seconds: <n> 
Error free seconds: <n> Number of sync losses: <n> 
Blocks received: <n> Block size: 511 or 2047 bits 
Call status: <status> Call setup time: <n> 
Call termination reason <reason> 
5-MIN WINDOW START TIME ERRORED-SECONDS ERRORS 

<TIMESTAMP> <NUMBER> <NUMBER> 


<TIMESTAMP> No data available. IBERT out of sync. 


Meaning: Display produced by display t test_ num command. The message for an 
intraswitched call shows the rest results for a single test. It includes the 
results summary and 5-min bin results (there may be up to 20 5-min bin 
results.) There is a possibility of the IBERT being out of synch when 
polled for the 5-min BIN as the message indicates. 


Action: None 
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display (continued) 


Responses for the display command (continued) 


MAP output Meaning and action 


Testbook ID: <id> Test number: <number> 
Call duration: <number> DN: <dialed DN> 
Start time: <dd month hh mm ss> Stop time: <dd month hh mm ss> 
IBERT: <n> (<ILC LEN> or <DTU mem>) Trunk member: <clli> <member> 
Errors <n> Errored seconds: <n> 
Error free seconds: <n> Number of sync losses: <n> 
Blocks received: <n> Block size: 511 or 2047 bits 
Call status: <status> Call setup time: <n> 
Call termination reason <reason> 
5-MIN WINDOW START TIME ERRORED-SECDONDS ERRORS 

<TIMESTAMP> <NUMBER> <NUMBER> 


<TIMESTAMP> No data available. IBERT out of sync. 


Meaning: Display produced by display t test_ num command. The message for an 
interswitched call shows the rest results for a single test. It includes the 
results summary and 5-min bin results (there may be up to 20 5-min bin 
results.) There is a possibility of the IBERT being out of synch when 
polled for the 5-min BIN as the message indicates. 


None 
Next summary unavailable 


Meaning: In a dial sequence, the next summary cannot be allocated due to 
memory shortage or the DCT_MEM_LIMIT is reached. 


Action: Free some summaries and try again. 
Test number is required in TERMRES testbooks. 


Meaning: A display on command in a TERMRES testbook. The test number must 
be specified in a TERMRES testbook. 


Action: Use the testbook command to see the list of current test calls running in 
the TERMRES testbook; then, reenter the display on command using 
the test number. 
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display (continued) 


Responses for the display command (continued) 
MAP output Meaning and action 


Test call <number> is not running in testbook <TERMRESO or TERMRES1>. 


Meaning: The test call number specified by the display on command for the 
TERMRES testbook is not currently running. 


Action: 


Use the testbook command to determine what test are running. 
WARNING: 


Test number ignored. 


TEst <id> is an originating testbook. 


Meaning: A test number is specified for continuous display in an originating 


testbook. The test number is simply ignored and the command is 
executed as if no test number were specified. 


Action: None 


Continuous DISPLAY is already ON. 


Meaning: The continuous display mode has already been turned on. 
Action: None 


Continuous DISPLAY is being used by another MAP. 


Meaning: The continuous display mode has been turned on at another MAP 
position. 


Action: None 


Continuous DISPLAY is ON. 


Meaning: The display on command has successfully executed. 


Action: None 


Continuous display is already off. 


Meaning: Continuous display mode is off when display off command is entered. 
Action: None 
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display (end) 


Responses for the display command (continued) 


MAP output Meaning and action 


Testbook Test Number of Errored 
ID number bit errors seconds Timestamp 
<ID> T:<n> E:<n> ES:<n> <time> 


<ID> T:<n> E:<n> ES: <n> S:<n> <time> 
<ID> T:<n> IBERT is out of sync <time> 
<ID> T:<n> Cout not poll IBERT <time> 


Meaning: This message is the contents of the continuous display response. The 
last two lines are displayed only if the IBERT was out of sync or polling a 
bad IBERT. 


Action: None 
Test number <n> not found. 
Meaning: The command display t <n> is entered where no test number <n> exists. 
Action: Use the testbook command without any parameters or the count 
command to determine what tests are running. Use the DCTTOOL level 


display all command to display all test numbers. 


DCT is unavailable. System maintenance in progress. 


Meaning: A display on or display off command is entered when DCT processing 
software is unavailable to handle the command. 


Action: Try the command again later. 


DISPLAY command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The internal DCT MAP to DCT process message to initiate continuous 
display is not acknowledged. Positive feedback cannot be given to the 
user about the status of the command. A SWERR is generated 
indicating that a time out has occurred. 


Try the command again later, and report the SWERR. 
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hold 


Function 
Use the hold command to move the line in the control position to a spare 
hold position, and move the next line from the posted set, if any, to the 
control position. 


hold command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualification 


The hold command is qualified by the following exceptions, restrictions, and 
limitations: 


e Ifa line in the control position is one of a posted set, it is removed from 
the posted set when it is placed in a hold position. 


e This command also applies to Integrated Services Digital Network 
(ISDN) lines. There are no additional responses for ISDN lines. 


Example 
The following table provides an example of the hold command. 


Example of the hold command 


Example Task, response, and explanation 


Task: Move the line in the control position to a spare hold position, and 
move the next line from the posted set to the control position. 


Response: The system transfers the dn of the line in the control position, and 
all other line information displayed to the right of it, to an available 
hold position. The system then places another line in the control 
position. The quantity beside the label POST decreases by one. 


Explanation: The system transfers the line in the control position, which is part of 
a posted set, and its associated data to an available hold position. 
The system places the next line in the posted set in the control 
position. 
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hold (end) 


Responses 


The following table provides explanations of the responses to the hold 
command. 


Responses for the hold command 
MAP output Meaning and action 
ALL HOLD POSITIONS FILLED 
Meaning: A line occupies each of the hold positions. 


Action: None 


The dn of the line in the control position, and all other line information displayed to the right of it, is 
transferred to an available hold position. 


Meaning: The system transfers the line in the control position and its associated 
data to an available hold position. Since the line in the control position is 
not part of a posted set, no other line is placed in the control position. 


None 


The system transfers the dn of the line in the control position, and all other line information 
displayed to the right of it, to an available hold position. The system then places another line in the 
control position. The quantity beside the label POST decreases by one. 


Meaning: The system transfers the line in the control position, which is part of a 
posted set, and its associated data to an available hold position. The 
system places the next line in the posted set in the control position. 


Action: None 
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Function 
Use the inject command to inject up to 16 bit errors in the current test. 


inject command parameters and variables 


Command Parameters and variables 


inject errors num no t 
t tst_ num 


Parameters 
and variables Description 


errors_num This variable is the number of bit errors to be injected and has a range of 1-16. 


no t This default parameter, which is never entered, indicates that no test number will 
be specified. 


This parameter indicates that a test number will be specified, and must be followed 
by the tst_num variable. 


ist num This variable is the number of the test to have bit errors injected into itand has a 
range of 1-65535. 


Qualifications 


The inject command is qualified by the following exceptions, restrictions, 
and limitations: 


e The inject command is ignored if no testbook is active. 


e The inject command issued without a test number applies to the current 
test of originating testbooks. If no test is running in the active testbook, 
the inject command is ignored 


e If the inject command is issued with a test number, that number has to 
correspond to the current test in originating testbooks, or to one of the 
running tests in TERMRES testbooks to avoid the command being 
rejected. 
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inject (continued) 


Examples 
The following table provides examples of the inject command. 


Examples of the inject command 


Example Task, response, and explanation 


inject 2 
where 


2 is the number of bit errors to be injected 
Task: Inject two bit errors into the currently running test. 


Response: 2 bit error(s) INJECTed into test 123 of 
testbook Z1. 


Explanation: Command is successful 


inject 11 t 147.1 
where 


11 is the number of bit errors to be injected 
147 is the number of the test affected 


Task: Inject 11 bit errors into test 147. 


Response: INJECT command not executed. 
Test 147 is not running in testbook LIEM 


Explanation: The current testbook is LIEM and test 147 is not running in it. 
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inject (continued) 
Responses 


The following table provides explanations of the responses to the inject 
command. 


Responses for the inject command 
MAP output Meaning and action 


INJECT command not executed. 


Meaning: The inject command is not successfully executed because a wrong 
parameter is entered or there is no running test to which to inject errors. 


Action: None 
<n> bit error(s) INJECTed into test <m> of testbook <id>. 
Meaning: The number of bit errors <n> have been injected into test number <m> 
of the testbook identified by <id> indicating successful completion of the 


inject command. 


Action: None 


No test call running in testbook <id> 


Meaning: No test call is running in the active testbook when the inject command is 
issued. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the inject command is issued. The inject 
command applies only to the active testbook. 


Action: Access the testbook, and try again. 
Test <n> is not running in testbook <id> 


Meaning: The inject command is issued with a test number that does not 
correspond to a test currently running. 


Action: Use the testbook command to check the running test numbers. 
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Responses for the inject command (continued) 
MAP output Meaning and action 
Test number must be specified in TERMRES testbooks. 

Meaning: The inject command is issued whthout a test number when the active 
testbook is either TERMRESO or TERMRES1. Because many test calls 
can be concurrently running in TERMRES testbooks, the test call to 
inject error into must be specified. 

Action: Reissue the inject command with the desired test number. 


No dial command is executing. 


Meaning: The inject command is issued for a testbook in which there is no dial 
command running. 


Action: Issue a dial command, then reissue the inject command. 
An INJECT command is running in test <n> of testbook <id>. 

Meaning: This response is generated during an ILC-ILC call. It will only appear if 
the inject command is issued in the originating testbook and in the 
corresponding TERMRES test. Simultaneous injects into the same test 
call of an ILC-ILC call is not supported. 


This response also occurs when the inject command is entered on the 
same testbook from two different MAP sessions. 


Action: None 
IBERT is out of sync. 


Meaning: The inject command is issued while the IBERT involved in the test call is 
out of sync. 


Action: Wait for IBERT to reestablish sync, and reissue the command. 
IBERT is unavailable. 


Meaning: The inject command is issued while the IBERT involved in the test call 
cannot communicate with the DCT process. 


Action: Repeat the command when IBERT has regained messaging. 
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inject (end) 
Responses for the inject command (continued) 
MAP output Meaning and action 
Delayed DIAL has not started yet. 


Meaning: The inject command is issued before a delayed dial command has 
started a test call. 


Action: Wait for delayed dial to start a test call, then reissue inject command. 
DCT is unavailable. System maintenance in progress. 


Meaning: The inject command is issued while the DCT process is initializing. 


Action: Wait for DCT process to finish initializing, then reissue the inject 
command. 


INJECT command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The inject command encounters an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try again. 


Action: Report any SWERRS. 
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next (end) 


Function 


Use the next command to place the next higher PM of the posted DTC set 
into the control position. 


next command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that the next PM in the 
post set, regardless of type, will be posted because no PM type is specified. 


This variable specifies a PM type and enables the system to select a specific PM 
type to post. Use the disp command to display the list of PM types in the posted 
set. The system selects the PMs in the sequence displayed by this list. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


The following table provides an explanation of the response to the next 
command. 


Responses for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed PM is the last in the posted set of PMs. 


Action: None 
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post 
Function 


Use the post command to select a specific DTC upon which action is to be 
performed by other commands. 


post command parameters and variables 


Command Parameters and variables 


pm_type nnn ...ann 


Parameters 
and variables Description 


This variable identifies a PM of node-type DTC when dtc is entered. If a level of tHe 
node-type is already accessed, the pm_type may be omitted from the command 
entry. A PM in the control position of the posted set is the default. 


This variable identifies the discrimination number of the DTC to be posted. The 


range is 0-127. When more than one PM is to be posted, the discrimination num- 
bers are entered with a blank space separating them. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 
limitations. 


e The post command must be used before using the commands trnsl, tst, 
bsy, rts, and offl. 


e When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs that are present in the office configuration. For parameters that do 
not apply, one of several responses indicates that it is ignored. 
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post (continued) 


Examples 
The following table provides an example of the post command. 


Examples of the post command 


Example Task, response, and explanation 


post dtc 8. 
where 


8 is the descrimination number of the DTC to be posted. 
Task: Post DTC 8. 
Response: DTC 8 InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 


Unitl: Inact InSv 


Explanation: DTC 8 is posted. 


Responses 


The following table provides an explanation of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


NO PM POSTED 


Meaning: A PM level is accessed without any PM being posted. 


Action: None 
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post (end) 


Responses for the post command (continued) 
MAP output Meaning and action 
pm pm_number n_state LINKS OOS: CSIDE nn PSIDE nn 


UNIT 0: activity u_state MTCE /LOADING: nnnn 
UNIT 1: activity u_state MCTE LOADING: nnnn 


Meaning: When a PM is posted, its status is displayed, where: 


pm is one of the types of PM types listed in the PM 
status code table at the PM level commands. 


pm_number is the discrimination number of the PM type. 


n_state is the state of the PM node. The displayed state 
depends on the state of one or both units. 


LINKS_OOS indicates the quantity of equipped C-side and P-side 
links that are out of service because they are either 
system busy or manually busy. 


activity indicates which unit is available for call processing 
and which unit is on standby. ACT means the unit is 
active and able to handle call processing; INACT 
means the unit is on standby (inactive). 


is the status of a unit. 


indicates the unit is undergoing maintenance initiated 
manually or by the system (displayed with u_states 
ManB and SysB, respectively). MTCE is present 
only while maintenance is occurring. 


/LOADING: indicates the unit is being updated with datafill, where 
nnnn is an increment of the load. 


Action: None 


<PM> <num> InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 
Unitl: Inact InSv 


Meaning: The specified <PM> nunmber <num> is posted. 


Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DCTTTP level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DCTTTP level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DCTTTP level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DCTTTP level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DCTTTP level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DCTTTPlevel with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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release 


Function 


Use the release command to terminate the current test call of the active 
testbook. 


release command parameters and variables 


Command Parameters and variables 


release There are no parameters or variables. 


Qualifications 


The release command is qualified by the following exceptions, restrictions, 
and limitations: 


e When the current test call is released, the next test call in the executing 
dial command is started immediately, even if a delay time is specified, 
unless it is paused. If is is paused, the next test call is started when the 
dial command is resumed. 


e The release command is only valid if a testbook is active. 


e The release command applies only to the current test of the active 
testbook. If no test is running, no test is released, even if dial command 
is executing and is waiting between calls. 


e Test summaries show if atest has been released. 
e The release command cannot be executed in a TERMRES testbook. 


Example 
The following table provides an example of the release command. 


Example of the release command 


Example Task, response, and explanation 
release | 


Task: Release current test. 


Response: RELEASE command completed. 
Current test call in testbook xv123 is RELEASEd. 


Explanation: The current test is released. 
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release (continued) 


Responses 


The following table provides explanations of the responses to the release 
command. 


Responses for the release command 
MAP output Meaning and action 
RELEASE command not executed. 


Meaning: General message indicating unsuccessful execution of release 
command. 


Action: None 


RELEASE command completed 


Meaning: General message indicating successful execution of release command. 


Action: None 


No testbook is active. 


Meaning: No testbook is active when the release command is entered. The 
release command is only valid when a testbook is active. 


Action: None 


Current test call in testbook <ID> is RELEASEd. 
Meaning: Test call has been successfully released. 


Action: None 


Proceeding with next test call. 
Meaning: The test call released by the release command is not the last one in the 
current dial command. It indicates to the user that execution of the next 
test call is going to start. 


Action: None 


Last test call in DIAL has been RELEASEd. 


Meaning: The last test call in the dial has been released; therefore, the entire dial 
command is finished. 


Action: None 
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Responses for the release command (continued) 
MAP output Meaning and action 
A TERMRES testbook is active. 


Meaning: A TERMRES testbook is the active testbook when the release command 
is entered. Tests in TERMRES testbooks cannot be released. 


Action: None 
No DIAL command is executing. 


Meaning: A release command has been entered in a testbook that has no dial 
command running. 


Action: None 
The DIAL sequence is PAUSEd. 


Meaning: A release command has been entered while a dial command is being 
paused. The release is simply ignored. 


Action: None 


Current delay to next test call is RELEASEd. 


Meaning: A release has been issued during the delay between calls in the dial 
sequence. The delay is cancelled, and the next call is started. 


Action: None 
Delayed DIAL has not started yet. 


Meaning: A delayed DIAL has been issued. The release 3 cannot release a test 
call that has not started executing yet. 


Action: None 


DCT is unavailable. System maintenance in progress. 


Meaning: The DCT process is temporarily unavailable due to the process dying. 
The DCT process will restart itself; then, the full set of DCT commands 
will be available. 


Action: Wait, and try again later. 
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release (end) 


Responses for the release command (continued) 
MAP output Meaning and action 


RELEASE command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The release command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. 


Action: Report any SWERRS, and try the command again. 
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select 


Function 
Use the select command to perform the following functions: 


e select a particular IBERT for use in subsequent dial commands that use 
the S option. The IBERT can be either an ILC or DTU 


e select a particular outgoing trunk group or trunk group and trunk 
member for use in subsequent dial commands that use the S option 


e select the posted item (trunk group or member ILC) for use in 
subsequent dial commands that use the S option 


e select an incoming trunk for translation purposes, with optional bearer 
capability when it is different from the default of 56KDATA 


e select an originating trunk for translation purposes, with optional bearer 
capability when it is different from the default of 56KDATA 


e select a default translation agent (default incoming trunk and member). 
which will apply for all DCT testbooks in the given office 


e deselect all previously made selections 
e display selections 


select command parameters and variables 

Command Parameters and variables 

select posted 
clear 
defintrk 
intrk 


bc_name 


orgdn 
bc_name 


dtu_num 


tk_grp 
tk_num 


ibert_num 


site drawer circuit 
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select (continued) 


select command parameters and variables 


Parameters 
and variables 


drawer 
dtu 
dtu_num 
frame 


ibert 


ibert_num 


intrk 


Description 


This default parameter causes all previous selections to be deselected and does 
not need to be entered. 


This parameter indicates that bearer capability is to be selected with the incoming 
trunk 


This variable is the identification of the bearer capability of the incoming trunk 
and must be one of the following: 


speech 
56kdata 
64kdata 


This variable is the circuit number and has a range of 0-99. 
This parameter deselects all previous selections. 


This parameter selects an incoming trunk for translation emulation like the intrk 
parameter, but it is also the default for all testbooks. The defintrk parameter must 
be followed by tk_grp or tk_num variable, or bc parameter and bc_name variable. 


This variable is the drawer number and has a range of 0-99. 

This parameter indicates that a DTU member is to be specified. 

This variable is the number of the DTU member and has a range of 0-9999. 
This variable specifies the frame number of the ILC and has a range of 0-511. 


This parameter indicates that an IBERT number is to be specified from table 
FMRESINV. 


This variable is the number of the IBERT and has a range of 0-127. 


This parameter selects an incoming trunk for translation emulation and must be 
followed by tk_grp or tk_num variable, or bc parameter and bc_name variable. 


This parameter indicates that an ILC (LEN) is specified. 


This default parameter, which is never entered, indicates that no bearer capability 
is to be selected for the incoming trunk. 
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select (continued) 


select command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is a string defining the originating DN. 
This parameter indicates that an originating DN is specified. 
This default parameter, which is never entered, indicates that the posted item 


(trunk, trunk member, DTU, ILC) will be selected because the select command is 
entered with no parameters. 


This parameter causes all previously made selections to be displayed. 


This variable is a string with the site name. 
This variable is the trunk group clli used with the g, intrk, or defintrk parameters. 


This variable is the number of the trunk member used with the g, intrk, or defintrk 
parameters and has a range of 0-9999. 


This variable is the unit number of the ILC and has a range of 0-9. 


Qualifications 


The select command is qualified by the following exceptions, restrictions, 
and limitations: 


e Selections apply on a testbook basis. Selections other than the default 
translation agent are specified only once in each testbook. 


e The command select ibert <n> stores the actual IBERT circuit id and not 
the IBERT number in table FMRESINV. Therefore, if the datafill in this 
table is changed, select query and display will show the new number 
assigned to this IBERT. If this tuple is deleted, NIL is shown in place of 
the IBERT number. The IBERT circuit ID (that is DTU 0) is still shown. 


e The default translation agent once selected will apply to all testbooks in 
the given switch or office. 
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select (continued) 


Examples 


The following table provides examples of the select command. 


Examples of the select command 


Example 


select — 


Task, response, and explanation 


Task: Select the currently posted ILC 
Response: Trunk group OTTMTL23 SELECTed 


Explanation: The SELECT command without any parameters selects the posted 
item. 


select g isupibnog 13. 


where 


isupibnog 


13 


is the name of the trunk group 
is the number of the member of the group to be selected. 


Task: Select member 13 of trunk group isupibnog. 


Response: Trunk group ISUPIBNOG member 13 SELECTed. 


Explanation: Member 13 of trunk group isupibnog is selected. 


select dtu 7 J 


where 


7 


is the number of the DTU to be selected 
Task: Select IBERT DTU 7. 
Response: IBERT DIU 7 SELECTed. 


Explanation: Selection is successful. 
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Examples of the select command (continued) 


Example Task, response, and explanation 


select 1 host 0123 
where 


host is the site name 
is the frame number 
is the unit number 
is the drawer number 
is the circuit number 


Task: Select circuit 4 in drawer 3 of unit 2 in frame 1 of host ILC. 
Response: IBERT ILC LEN HOST 00 0 00 00 SELECTed. 


Explanation: The specified IBERT ILC LEN is selected. 
select clear — 


Task: Clear all previous selections 


Response: The following selections will be cleared in this 
testbook: 
- Outgoing trunk/member 
- IBERT 
Please confirm (“YES”, “Y”, “NO”, or “N”): 
>Y 
Outgoing trunk and IBERT SELECTions have been 
CLEARed. 


Explanation: 
select query .| 


Task: Display all previous selections. 


Response: 
Current SELECTions: 
Outgoing trunk: ISUPIBNOG 0 
IBERT: DTU 9 
Agent fro translation: default translation agent 
Bearer Capability: 56KDATA 
Default translation agent: ICMF 
Default bearer capability:64KDATA 


Explanation: All previous selections are displayed. 
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Examples of the select command (continued) 


Example Task, response, and explanation 


select orgdn 7657962 bc 64KDATA .| 
where 


7657962 is the originating dn 
Task: Select the originating DN 7657962. 
Response: Originating DN 7657962 SELECTed for translation. 


Explanation: The specified originating dn is selected. 


Responses 


The following table provides explanations of the responses to the select 
command. 


Responses for the select command 


MAP output Meaning and action 


SELECT command not executed 


Meaning: The select command is not successfully executed because the user 
replies no to the confirmation prompt or an invalid parameter is entered. 


Action: None 


Trunk group <clli> SELECTed. 


Meaning: The select command has successfully selected a trunk group. 


Action: None 
Trunk group <clli> member <member> SELECTed. 
Meaning: The select command has successfully selected a trunk member. 


Action: None 
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Responses for the select command (continued) 
MAP output Meaning and action 


IBERT DTU <DTU mem> SELECTed. 
Meaning: The select command has successfully selected a DTU. 


Action: None 


IBERT ILC LEN <ILC len> SELECTed 


Meaning: The select command has successfully selected an ILC. 


Action: None 


Post set is empty. 


Meaning: The select command is issued with no parameters and nothing is 
posted. 


Action: POST an outgoing trunk or ILC and reissue the command. 
Trunk group <clli> does not exist. 
Meaning: The trunk selected is not correctly datafilled or not correctly entered. 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM to determine 
where error is. Correct error and reissue command. 


Trunk group <clli> does not use Rl or ISUP signalling. 


Meaning: The trunk member selected does not use R1 or ISUP signaling types. 


Action: Select another trunk which uses R1 or ISUP signaling. In table 
TRKSGRP, the fields SIGDATA must be either C7UP or STD. Also, 
OPULSTYP/IPULSTYP must be MF in case of STD signaling. 


Trunk group <clli> member <number> does not exist. 

Meaning: The trunk member selected is not datafilled. 

Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 
IBERT DTU <DTU mem> does not exist. 

Meaning: The DTU being selected is not datafilled 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 
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Responses for the select command (continued) 


MAP output Meaning and action 


IBERT ILC LEN <ILC len> does not exist. 
Meaning: The ILC being selected is not datafilled. 


Action: Check tables LNINV and FRMRESINV. 


The following selections will be cleared in this textbook: 
- Outgoing trunk/member 
- Ibert 
_ Emulated translation agent 


Meaning: This message confirms resetting the outgoing trunk and IBERT 
selections after the user has issued a select clear command. The last 
item is only shown when the option ALL is specified. 


Action: None 


Current SELECTions: 
Outgoing trunk: <trkclli> <trkmem> 
IBERT: <<ILC LEN> or DTU <DTU mem>> 


Agent for translation: <trunk>/<DN> or Default translation agent 
Bearer Capability: <BC name> 


Default translation agent: <trkclli> <trkmem> 
Default bearer capability: <BC name> 


Meaning: This message is a list of all selections in response to the selected query 
command. If the select query is issued in a TERMRES testbook or 
outside of a testbook, only the default translation agent and the bearer 
capability are displayed. 


Action: None 


Present default translation agent is <clli> <member> <BC name>. 
Do you want to replace it with <clli> <member> <BC name>? 


Meaning: This prompt is the response to the select defintrk command with a 
parameter when a default value already exists. 


Action: Respond with y to confirm or n to abort the command. 
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Responses for the select command (continued) 


MAP output Meaning and action 


Default translation agent <clli> <member> <BC name< SELECTed. 
It is the default for all testbooks. 


Meaning: This is the response when a select defintrk command is confirmed and 
validated successfully. 


Action: None 
No test book is active. 
Meaning: This is the response to a select command when there is no active 
testbook. The default translation agent applies to all testbooks while all 
other sections apply only to active testbooks. 


Action: Access a testbook and try again. 


SELECTions are disallowed from TERMRES testbooks. 


Meaning: Select has been attempted from within testbook TERMRESO or 
TERMRES1. 


Action: Activate an originating testbook, and reissue the select command. 
Incoming trunk <clli> <mem> SELECTed for translation. 


Meaning: This is the response to a successfully selected and valid incoming trunk 
and member for pretranslation. 


Action: None 
Incoming trunk <clli> <mem> is invalid. 
Meaning: The selected incoming trunk, member, or both are not datafilled. 


Action: Check tables CLLI, TRKGRP, TRKSGRP, and TRKMEM. 


Originating DN <dn> SELECTed for translation. 


Meaning: This is the response to a successfully selected and valid originating DN 
of a DU for pretranslation. 


Action: None 
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Responses for the select command (continued) 
MAP output Meaning and action 
Originating DN <dn> is invalid. 
Meaning: The selected originating DN is not datafilled. 


Action: Check tables DNINV and KSETLINE. 


Bearer capability <BC name> is also SELECTed. 


Meaning: This message is displayed upon successful selection of an agent for 
translation. 


Action: None 


Bearer capability <BC name> is invalid. 
56KDATA is used instead. 


Meaning: This message is not currently used. It is displayed only when the 
MAPCL is in severe difficulty. 


Action: None 


Trunk group <clli> is not an incoming or 2-way trunk. 


Meaning: The incoming trunk being selected is not capable of supporting incoming 
traffic. 


Action: Check the trunk direction in tables TRKGRP and TRKSGRP. 


Trunk group <clli> is not an outgoing nor 2-way trunk. 


Meaning: The incoming trunk being selected is not capable of supporting outgoing 
traffic. 


Action: None 
IBERT DTU <DTU mem> cannot be used by DCT. 


Meaning: The DTU being selected is datafilled in table FMRESINV, but DCT is not 
a valid user ofthe DTU. 


Action: Use the select command to select a DTU which belongs to DCT class, 
or change the datafill in table FMRESINV, 
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Responses for the select command (continued) 


MAP output Meaning and action 


IBERT ILC LEN <ILC len> cannot be used by DCT. 


Meaning: The DTU being selected is datafilled in table FMRESINV, but DCT is not 
a valid user of that DTU. 


Action: Use the select command to select an ILCk which belongs to DCT class, 
or change the datafill in table FMRESINV, 


Outgoing trunk and IBERT SELECTions have been CLEARed. 


Meaning: This message confirms the resetting of the outgoing selections as well 
as IBERT selections. 


Action: None 
All SELECTions have been CLEARed. 


Meaning: This message confirms the resetting of all selections previously made, 
excluding the default translation agent. 


Action: None 
Incoming trunk <clli> <mem> is not supported. 


Meaning: The selected incoming trunk, member, or both are datafilled but are not 
trunk types that DCT supports. 


Action: None 
LENs are not supported in Toll Offices. 
Meaning: The user has attempted to select a DN for emulation. DNs and their 
basis, LENs, do not exist in toll offices. This message also appears 


when the user issues the select | command while in a toll office. 


Use an incoming trunk as originating agent; that is, select intrk or 
defintrk, and the DTU as test head; that is, select dtu or ibert. 


Unable to SELECT Posted Item. 


Meaning: There has been an abnormal error while attempting to execute the select 
posted command; that is, select with no parameters. 


Action: Post the item, and try the select command again. 
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Responses for 
MAP output 


level commands 


the select command (continued) 


Meaning and action 


SELECT command failed. Try again 
Report swerr to the next level of support. 


Meaning: There has been an abnormal error while attempting the select 
command. The conditions that caused the failure are sometimes 
transient, so the user is asked to try again. 


Action: Report any SWERRS. 


IBERT <n> does not exist 


Meaning: This message is displayed when the selected IBERT <n> is not 
datafilled in table FMRESINV. 


Action: Check table FMRESINV, and datafill IBERT <n>. 


IBERT <n> cannot be used by DCT. 


Meaning: The IBERT <n> is datafilled in table FMRESINV but not for DCT 
application class. 


Action: Use the select command to select an IBERT which belongs to DCT 
class, or change the datafill in table FMRESINV. 


IBERT <n> is SELECTed. 


Meaning: IBERT has been successfully selected. 


Action: None 


Outgoing trunk <clli> is not supported. 


Meaning: The selected outgoing trunk, member, or both are datafilled but are not 
trunk types the DCT supports. 


Action: In table TRKGRP ensure that the field GRPTYPE is IBNTO, IBNT2, IT, 
T2, TO, OR OC. 


297-1001-821 Standard 04.01 June 1999 


DCTTTP level commands D-275 
stop 


Function 


Use the stop command to terminate the current test call and all remaining 
test calls in the dial sequence in the active testbook immediately. 


stop command parameters and variables 


Command Parameters and variables 


There are no parameters or variables 


Qualifications 


The stop command is qualified by the following exceptions, restrictions, and 
limitations: 


e The stop command is only valid if a testbook is active. 


e The stop command applies only to the current test of the active testbook. 
If no dial command is currently executing, the command is ignored. 


e The stop command cannot be executed from TERMRES testbooks. 
Example 


The following table provides an example of the stop command. 


Examples of the stop command 


Example Task, response, and explanation 


Task: Stop current and remaining tests in current dial sequence. 


Response: STOP command completed. 
DIAL command in testbook mt111 is being STOPped. 


Explanation: The stop command has successfully executed. 
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Responses 


The following table provides explanations of the responses to the stop 
command. 


Responses for the stop command 
MAP output Meaning and action 
STOP command not executed. 


Meaning: The general message is displayed when the stop command is not 
successfully executed. 


Action: None 


No testbook is active 


Meaning: No testbook is active when the stop command is entered. The stop 
command is only valid when a testbook is active. 


Action: None 


No DIAL command is executing. 


Meaning: No dial command is executing in the active testbook when the stop 
command is entered. 


Action: None 


DIAL command in testbook <ID> is being STOPped. 


Meaning: The general message is displayed when the stop command is 
successfully executed. 


Action: None 


A TERMRES testbook is active. 


Meaning: A TERMRES testbook is the active testbook when the stop command is 
entered. Tests in the TERMRES testbooks cannot be stopped. 


Action: Access the originating testbook, and try again. 
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Responses for the stop command (continued) 
MAP output Meaning and action 
DCT is unavailable. System maintenance in progress. 
Meaning: The DCT process is temporarily unavailable due to the process dying or 
system maintenance. The DCT process will restart itself; then, the full 
set of DCT commands will be available. 


Action: None 


STOP command failed. Try again. 
Report swerr to the next level of support. 


Meaning: The stop command encountered an unexpected error condition. The 
error condition is sometimes transient, so the user is asked to try the 
command again. ASWERR is also generated. 


Action: Report SWERR, and try again. 
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Function 
Use the testbook command to do the following: 


e access a testbook 

e create a new testbook 

e display information on the active testbook 

e count the number of testbooks 

e lista specified number of testbook IDs from the list of testbook IDs 


e move the list index up or down a specified number of items in the list of 
testbook IDs 


testbook command parameters and variables 


Command Parameters and variables 


testbook active 
count 


down one 
up offset 


list three 
quantity 


point all 
position 
query tstbk_id 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that information on the 
active testbook is displayed because the testbook command is issued with no 
parameters. 


This parameter displays all testbook IDs in the list of testbooks. The index is moved 
to the bottom of the list. 


This parameter displays the number of testbooks that have been created. 


This parameter moves the index down (the number of items indicated by the offse 
variable) in the list of testbooks. The active test book is not affected. 


This parameter displays consecutive testbook IDs from the list of testbooks, starting 
at the current index position for as many testbooks as are indicated by the quantit 
variable. The index is moved down 3 positions. The active testbook is not affectef. 
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testbook command parameters and variables (continued) 


Parameters 
and variables 


tstbk_id 


Description 


The variable indicates the number of positions up or down to move the index and 
has a range of 1-256. 


This default parameter, which is never entered, indicates that the index will be 
moved up or down one position when no value for the offset variable is entered. 


This parameter points to the testbook ID at the position in the list of testbooks 
indicated by the position variable. This list is kept by the DCT tool and is in 
chronological order. This command does not affect the active testbook. 


This variable indicates the number of positions down from the first position to poin 
the index and has a range of 1-256. 


This variable indicates the number of testbook IDs to list and has a range of 1-256 
This parameter provides brief information on testbooks. 


This default parameter, which is never entered, indicates that three testbook IDs 
be listed when no value is entered for the quantity variable. 


This variable identifies the testbook that will be active, if it exists. If not, the user 
is prompted to create it. The variable may be replaced with any 1-8 character 
alphanumeric string, except for the following reserved keywords: 


count 
up 
down 
list 
point 


This parameter moves the index up (the number of items indicated by the offset 
variable) in the list of testbooks. The active test book is not affected. 
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Qualifications 


The testbook command is qualified by the following exceptions, restrictions, 
and limitations: 


e The testbook command prompts the user for confirmation before 
creating a new testbook to avoid crating new testbooks accidentally. 


e Real-time error display, requested by the display on command, is 
stopped when a new active testbook is entered; that is, the command 
testbook tstbk_id stops any previously requested real-time error display 
unless the tstbk_id is the ID of the currently active testbook. 


Examples 
The following table provides examples of the testbook command. 


Examples of the testbook command 


Example Task, response, and explanation 
testbook . 


Task: Determine the active testbook 


Response: 
Active testbook bcs35ck 
Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go by 


100 1011 1012 11 Testing JeanP 


Explanation: The active testbook and brief summary of contents are displayed. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-282 DCTTTP level commands 
testbook (continued) 


Examples of the testbook command (continued) 


Example Task, response, and explanation 


testbook xb25 J 
where 


xb25 is the ID of the testbook 


Task: Obtain brief summary of information on testbook xb25 


Response: 
TESTBOOK sb25 is now active. 
Active testbook xb25 
Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go 


25 50 51 200 Testing 


Explanation: A brief summary of the contents of xb25 is displayed. 


testbook liem . 
where 


liem is the ID of a new testbook to be created 
Task: Create new testbook liem. 
Response: Do you wish to create a testbook Liem? 
>y.J 


Test book Liem is now active. 


Explanation: The new testbook liem is created and is active. 
testbook count — 


Task: Determine how many testbooks there are. 


Response: Number of testbooks is 126 


Explanation: The number of testbooks is counted and displayed. 
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Examples of the testbook command (continued) 


Example Task, response, and explanation 


testbook 300 — 
where 


300 is the number of positions the index is to move down form the top 


Task: Point index to ID of testbook 300 positions from the top of the list. 
Pointing to testbook prob512 

Number Last Created 
of tests used by 


Response: 
Testbook Number 
ID of users 


prob512 3 93 1993/03/09 11:24:42 HAIN 


Explanation: prob512 is the ID of testbook 300 positions from the top. 


testbook list all . 
Task: List all of the testbooks. 
Response: 


Testbook Number 
ID of users 


Last Created 
used by 


Number 
of tests 


TERMRESO 


TERMRES 
Z1 

Z2 
Homerl 
Homer2 
Number 
Bottom 


Explanation: 


1 


5 
5 
1 
3 
al 


4 
of testbooks listed: 
of testbook list. 


All testbooks are listed. 


1993/03/09 
1993/03/09 
1993/03/10 
1993/03/10 
1993/03/15 
1993/03/15 


6. 


DCT 

DCT 
ZEGRAY 
ZEGRAY 
HOMAYOON 
HOMAYOON 
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Responses 
The following table provides explanations of the responses to the testbook 


command. 


Responses for the testbook command 
MAP output Meaning and action 
Testbook <ID> is now active. 
Meaning: This message confirms that the testbook is now active. 


Action: None 


No testbook is active. 


Meaning: This message appears when the testbook command with no parameters 
or with query keyword is issued before setting an active testbook. 


Action: Access a testbook, and try the command again. 


Do you wish to create testbook <ID>? 


Meaning: The message prompts the user to confirm creating a new testbook ID 
before proceeding. 


Action: Respond with a y to confirm testbook creation or with an n to reject 
testbook creation. 


TESTBOOK command not executed. 
Meaning: This is a general message displayed when the testbook command is not 
successful, for example, when the user replies with no to the prompt for 
creating a testbook or an invalid option or keyword is entered. 


Action: None 


Number of testbooks listed : <n> 


Meaning: This message displays the number of testbooks listed, as requested by 
the testbook list command, where <n> is the number of testbooks. 


Action: None 
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testbook (continued) 
Responses for the testbook command (continued) 


MAP output Meaning and action 


Number of testbooks is <n> 


Meaning: This message displays the number of testbooks as requested by the 


testbook count or query command, where <n> is the number of 
testbooks. 


Action: None 
Top of testbook list 
Meaning: This message is displayed whenever the index to the list of testbooks is 


taken to the top of the list by a testbook point or testbook up command. 
Action: None 


Bottom of testbook list 


Meaning: This message is displayed whenever the index to the list of testbooks is 


taken to the bottom of the list by a testbook point, testbook down, or 
testbook list command. 


Action: None 


Pointing to testbook <ID>. 


Meaning: This message is part of the acknowledgement of testbook point, 
testbook up, or testbook down. It displays the testbook ID at the 
resulting position. 


Action: None 


Continuous DISPLAY OFF for previous testbook <ID>. 


Meaning: This message informs the user that the display on command issued from 


the previous testbook has stopped when the testbook <ID> was issued. 
Refer to the display command. 


Action: None 


Active testbook <ID> 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters or with query keyword. 


Action: None 
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Responses for the testbook command (continued) 


MAP output Meaning and action 


Testbook Number Number Last Created 
ID of users of tests used by 


<number> <number> <date/time> <user_ID> 
<number> <number> <date/time> <user_ID> 


<number> <number> <date/time> <user_ID> 


Meaning: This message is the response to the testbook list command. It displays 
a list of testbook IDs, where: 


<ID> is the testbook identification 

<number> is the number of users or number of tests 
<date/time> is the date and time last used 

<user_ID> is the identification of the user who created the 


testbook 
Action: None 


There are no testbooks 


Meaning: This message is the responce to the command testbook up, testbook 
down, testbook list, or testbook point when there are no testbooks. 
Because testbooks TERMRESO and TERMRESI1 are always present, 
this response should not appear under normal conditions, but can 
appear if TERMRES testbooks were not created and no originating 
testbooks have been created yet. 


Action: Try the command again, and report this error to the next level of support. 


DCT Office parameters are being changed. Try again later. 


Meaning: This message responds to a testbook being selected when DCT Office 
parameters are being changed. This is because changing the OFENG 
parameter DCT_MEM_LIMIT may cause the testbook memory structure 
to be affected. No testbooks should be accessed while 
DCT_MEM_LIMIT is being changed. 


Action: Wait, and try again later. 
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Responses for the testbook command (continued) 
MAP output Meaning and action 
Testbook list is busy. Try again later. 


Meaning: This message is the response to an attempts to execute testbook 
commands at more than one MAP at a time. 


Action: Wait a few moments, then try again. 


There is no memory available to create a testbook. 


Meaning: An attempt to create a testbook has occurred when no more memory 
resources have been allocated to the DCT. 


Action: The user should delete unneeded test results and testbooks, and try 
again. 


There is a maximum of 256 testbooks. 


Meaning: This message is the response to an attempt to create a new testbook 
when the maximum of 256 testbooks, including TERMRESO and 
TERMRESI1, have already been created. 


Action: The user should delete unneeded testbooks using the delete command. 


Severe error condition. Cannot create or delete testbooks. 


Meaning: This message is the response to an attempt by the user to create or 
delete a testbook when certain resources are unavailable. This is 
usually associated with the repeated failure of the test call DCT 
processing software. In this case, only existing test results can be 
displayed or dumped to other media, and no test calls will be possible. 


Action: Try again, and if the same message appears, report this error condition. 
Test results should be dumped to other media in case of corruption of 
results. 


TESTBOOK LIST index is unpositioned. 
Use TESTBOOK POINT command to reposition. 


Meaning: This message is the response to testbook up, testbook down or testbook 
list when the testbook preciously indexed has been deleted. The index 
is unpositioned and must be repositioned. 


User should reposition the list index using the testbook point command. 
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Responses for the testbook command (continued) 


MAP output Meaning and action 


Active testbook bcs35ck 

Number Last Current Number DIAL Testbook 
of test test test of tests status created 
results performed number to go by 


<number> <number> <number> <number> <user_ID> 
or NONE or NONE or NONE 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters, or activating an existing testbook, 
where: 


<number> is the number of tst results, last test performed, 
current test number or number of tests to go. 

<user_ID> is the identification of the one who created the 
testbook. 


and where (*) is one of the following: 


none 
call setup 
testing 
inter-call delay 
paused 
delayed start 
- trial call 
Action: None 


Number of test results: <n>. Last test performed: <m>. 
Current test numbers: 
<list of current test call numbers> or NONE. 


Meaning: This message is part of normal response to the testbook command 
when issued with no parameters in, or activating terminating testbooks. 
It displays the total number of tests, the test numbers of the currently 
running tests in the terminating testbook (TERMRESO or TERMRES1). 


Action: None 
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testbook (end) 


Responses for the testbook command (continued) 


MAP output Meaning and action 


This testbook is being used for incoming tst call results. 


Meaning: This message is part of the normal response to the testbook command 
when issued with no parameters in, or activating terminating testbooks. 
It is displayed when currently running terminating tests are stored in the 
currently active terminating testbook (TERMRESO or TERMRES1). 
Note that only one terminating testbook can be used for incoming calls 
at a time, and will thus have this response. 


Action: None 
Testbook <ID> is the active testbook. 


Meaning: This message is the response to the testbook <ID> when that testbook 
is already the active one. In this case the only result of the user’s 
command will be to display this message. 


Action: None 


TESTBOOK commnd failed. Try again. 
Report swerr to the next level of support 


Meaning: This message is in response to an unknown internal software error. The 
system will generate a SWERR report. 


Action: 


Try again later. If the condition persists check and report any SWERRS 
generated. 
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D-291 


DDU level commands 


Use the disk drive unit (DDU) level of the MAP to test and change the status 
of the DDUs. 


Accessing the DDU level 
To access the DDU level, enter the following from the CI level: 
mapci;mtc;iod;ioc O;card 3 J 
In this example, 0 is the input/output controller (IOC) on which card 3 is 
attached to a DDU. 


DDU commands 
The commands available at the DDU MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DDU commands 


Command 


alloc 
bsy 
clrouff 
clrfcnt 
fent 
listdev 


offl 


quit 
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DDU commands (continued) 


Command 


DDU menu 


The following figure shows the DDU menu and status display. The insert 
with hidden commands is not a visible part of the menu display. 


Ext 


DDU IOD IOC 0 1 2 3 4 
0 Quit Stat 

2 

3 DIRP < XFER 

4 ListDev_ 

5 IOC Card 0 1: 2 3 4 5 

6 Tst 1 Port 0123 0123 0123 0123 0123 0123 

7 Bsy Stats TOO e s P SSSS 

8 RTS Type MID Cons DDU Cons DDU Cons 

9 Offl 

10 Card 4 Unit 1 

11 Start User SYSTEM Drive_State 
12 Stop Status Ready on_line 
1:3 

14 

15 Status 

16 Alloc Hidden commands 

17 Fent 

T8-CLrfent cTrburf 
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DDU status codes 


DDU level commands D-293 


The following table describes the status codes for the DDU status display. 


Status codes DDU menu status display 


Code Meaning 
System 
Ready ready 


Not not ready 
ready 


MBsy manually 
busy 


SBsy system 
busy 


Uneq unequipped 


Drive state 
being_allocated 
disconnected 
drive_faults 


on_line 
spinning 


spinning_up 
spun_down 
unknown 


Description 


The DDU is available. 


The DDU is not available. After being returned to service, the drive is na 
yet rotating at the proper speed or the system has not yet been able to 
read certain volume information concerning data blocks from the drive. 


The DDU has been placed in the manually-busy state. 
The DDU is in the system-busy state. 


The DDU is not equipped, indicating that the corresponding data entry fo 
the unit in table DDU has been deleted. 


An error has occurred during a system restart procedure. This state can 
be cleared by busying the unit and returning it to service. 


Volume allocation is being updated. 
The drive does not have power or it is incorrectly cabled to its controller. 


The drive has power, but is not responding to commands from its control 
ler. 


The drive is rotating, has been allocated, and is in service. 


The drive is rotating at the proper speed, but volume allocation has eithe 
not been done or is unknown. 


The drive is in the process of getting up to full speed. 
The drive has power but is not rotating. 


The drive state cannot be determined due to a failure in the controller or 
the message system. 


The drive state is nil, corresponding to an offline or unequipped controlle 
state. 
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alloc 


Function 


Use the alloc command to display information concerning the allocation of 
recording volumes on the drive. 


alloc command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 


The alloc command is qualified by the following exceptions, restrictions, 
and limitations: 


e The disk drive cannot identify volumes marked as unallocated. The 
system marks the volume status as closed, does not add it to the 
ROOTDIR directory, cannot use it for processing, and all of its 
information is lost. To correct this situation, use the bsy and rts 
commands on the DDU. If this fails to correct the problem, use the 
DSKALLOC utility program. 


e The system cannot read the volume label or the label information is 
corrupt. The system marks the volume status as closed, does not add it 
to the ROOTDIR directory, and cannot access 1t. The volume can be 
recovered by using the dirradd and update commands of the 
DSKALLOC utility. 


e The volume table of contents cannot be found. The system marks the 
volume status as closed, does not add it to the ROOTDIR directory, and 
cannot access it. The volume can be recovered by using the reinit and 
update commands of the DSKALLOC utility. 


Note: Volume files are lost following the use of the reinit command. 


e The system cannot process the space file. The system marks the volume 
status as open and read only then adds it to the ROOTDIR directory. 
The volume can be recovered by using the reinit and update commands 
of the DSKALLOC utility. 


Note: Volume files are lost following the use of the reinit command. 
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D-296 DDU level commands 
alloc (continued) 


Example 
The following table provides an example of the alloc command. 


Example of the alloc command 


Example Task, response, and explanation 


Task: Display information concerning the allocation of recording volumes 
on the drive. 


Response: 


VOLID VOL_NAME SERIAL_NO BLOCKS ADDR TYPE R/O FILES_OPEN 
IMAGE A000 12288 D010 NO 
voL1 A001 3000 D010 NO 
Unallocd A002 15004 D010 NO 


Explanation: The information is displayed. 


Response 


The following table provides an explanation of the response to the alloc 
command. 
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DDU level commands D-297 
alloc (end) 


Response for the alloc command 


MAP output Meaning and action 


VOLID VOL_NAME SERIAL_NO BLOCKS ADDR TYPE R/O FILES_OPEN 
IMAGE A000 12288 D010 
voL1 A001 3000 D010 
Unallocd A002 15004 D010 


Meaning: The number assigned to the volume is given under VOLID (volume ID). 
The name assigned to the volume when it was allocated is given under 
VOL_NAME. A system-assigned identifier, where the last digit matches 
the VOLID, is given under SERIAL_NO. The total number of kilobyte 
blocks of storage allocated to the volume is given under BLOCKS. The 
ADDR is the letter D, for DDU, followed by three digits identifying the 
DDU where the volume is located. Under TYPE, the error encountered 
when the volume was opened is given as one of the following integers. 


0 
no error was found 


4 
disk hardware cannot identify the volume 


2 
error reading the volume label 


3 
error processing the volume table of contents 


4 
error opening the space file 


Under R/O (read only), yes or no is displayed to indicate whether the 
volume has been given R/O status by the system following detection of 
an input/output error. The count of the number of files currently open on 
the volume is given under FILES_OPEN. 


Use the bsy and rts commands on the DDU if the disk drive cannot 
identify the volume. If this fails to correct the problem, use the 
DSKALLOC utility program. Use dirradd and update commands of the 
DSKALLOC utility if the volume label cannot be read. Use the reinit and 
update commands the DSKALLOC utility if there is a volume table of 
contents error or if there is an error opening the space file. 


Note: Volume files are lost following the use of the reinit command. 
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bsy 


Function 
Use the bsy command to change the state of the disk drive to manually busy. 


bsy command parameters and variables 


Command Parameters and variables 


noforce 
force 


Parameters 
and variables Description 


This parameter circumvents checking for open files and busies the DDU. 


This default parameter directs the system to check for open files and to abort the 
bsy command when files are open. Do not enter this parameter. 


Qualifications 


The bsy command is qualified by the following exceptions, restrictions, and 
limitations: 


e The force parameter should be used carefully. If appropriate, make 
copies of the open files before using the bsy force command string. The 
controller cannot be made manually busy by using the bsy command if 
the disk has open files on it without the use of the force parameter. 


e The request to make the controller manually busy will only be successful 
if the controller was in service, system busy, communications-side 
(C-side) busy, or offline. 


Example 
The following table provides an example of the bsy command. 


Examples of the bsy command 


Example Task, response, and explanation 


Task: Busy the DDU. 


Response: OK 


Explanation: The DDU is manually busy. 
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D-300 DDU level commands 


bsy (end) 


Responses 


The following table provides explanations of the responses to the bsy 
command. 


Responses for the bsy command 


MAP output Meaning and action 


At least one file is open on this disk. 
Open file(s) will be force closed 

Do you want to proceed? 

Please confirm (“YES” or “NO”): 


Meaning: You have used the bsy command with the force parameter and there is 
at least one open file on the DD. Continuing to force the DDU into the 
manually-busy state will cause open files to be forced closed. 


Enter yes to continue with the forced busy. Enter no to abort the 
command. 


Busy Request Failed 
1 file is open on volume JF. 


Meaning: There is a file open on the DDU and it cannot be busied. 


Action: Close the file and retry the bsy command. 


Failed 
Already Man Busy 


Meaning: The DDU is already manually busy. 


Action: None 


Failed 
Disk has open files. 


Meaning: The DDU cannot be made busy when it has open files on it. 


Action: Close the files and retry the bsy command. 


Meaning: The DDU is made manually busy. 


Action: None 
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clrbuff 


Function 
Use the clrbuff command to correct a software error condition when you 
cannot claim the maintenance buffer. 


clrbuff command parameters and variables 


Command Parameters and variables 


clrbuff There are no parameters or variables. 


Qualifications 
The clrbuff command is qualified by the following exceptions, restrictions, 
and limitations: 


e This command is used in response to the system message FAILED TO 
CLAIM MTCE BUFFER. 


e Use the clrbuff command only under the direction of technical support 
personnel. 


e The clrbuff command should not be used unless the DDU is 
out-of-service and no other maintenance requests are pending. 


Example 
The following table provides an example of the clrbuff command. 


Example of the clrbuff command 
Example Task, response, and explanation 
clrbuff I 


Task: Clear the maintenance buffer. 


Response: clrbuff 


Explanation: The maintenance buffer is cleared. 
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D-302 DDU level commands 
clrbuff (end) 


Response 


The following table provides an explanation of the response to the clrbuff 
command. 


Response for the clrbuff command 


MAP output Meaning and action 


clrbuff 


Meaning: The maintenance buffer is cleared. 


Action: None 
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clrfcnt 


Function 


Use the clrfcnt command to reset the values of the specified disk controller 
firmware counters to zero. 


clrfent command parameters and variables 
Command Parameters and variables 


clrfcnt cntr_num 
all 


Parameters 
and variables Description 


This parameter directs the system to reset all of the firmware counters. 


This variable is an integer representing the firmware counter to be reset. Valid 
entries are 1-25. 


1 error messages sent to central control, including cmdinval 
nacks on ingoing messages 

read block operations undertaken 

write block operations undertaken 

write block verify operations undertaken 

unused 

times disk variables required correction or relearn 


times configuration map required correction 


2 
3 
4 
5 
6 
7 
8 
9 


soft preamble errors 


=i 
o 


hard preamble errors 


_ 
_ 


soft data errors 


—h 
N 


hard data errors 


—_— 
o 


rereads during recovery procedures 


— 
> 


times tried for recovery 


_ 
al 


busy timeouts 
times disk sync not attained 


selector wait failures 
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clrfcnt (continued) 


clrfent command parameters and variables (continued) 


Parameters 
and variables Description 


disk clock failures 

reseek during recovery procedures 

seek faults 

drive faults 

head switches during recovery procedures 
commands rejected by disk 

times failed to recover data 


sector pulse dropouts 


Qualifications 
The clrfcnt command is qualified by the following exceptions, restrictions, 
and limitations: 


e The clrfcnt command is not a part of routine maintenance activities. 


e The clrfcnt command is normally used as an aid to isolating difficulties 
on the disk system during debugging procedures. 


Example 
The following table provides an example of the clrfcnt command. 


Examples of the cIrfent command 


Example Task, response, and explanation 


clrfcnt 18 .J 
where 


18 is the disk controller firmware counter to be cleared 


Task: Clear the disk clock failure disk controller firmware counter. 


Response: Disk physical fcnt cleared 


Explanation: The counter is cleared. 
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DDU level commands D-305 
clrfcnt (end) 
Response 


The following table provides an explanation of the response to the clrfcnt 
command. 


Response for the cIrfent command 


MAP output Meaning and action 


Disk physical fcnt cleared 


Meaning: The requested firmware counter is cleared. 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DDU level commands D-307 
fent 


Function 


Use the fent command to display the values of the specified disk controller 
firmware counters. 


fent command parameters and variables 
Command Parameters and variables 


cntr_num 
all 


Parameters 
and variables Description 


This parameter directs the system to display all of the firmware counters. 


This variable is an integer representing the firmware counter that is to be 
a Valid entries are 1-25. 


1 error messages sent to central control (including cmdinval) 
nacks on ingoing messages 

read block operations undertaken 

write block operations undertaken 

write block verify operations undertaken 

unused 

times disk variables required correction or relearn 


times configuration map required correction 


2 
3 
4 
5 
6 
7 
8 
9 


soft preamble errors 


= 
o 


hard preamble errors 


_ 
_ 


soft data errors 


—h 
N 


hard data errors 


_ 
o 


rereads during recovery procedures 


— 
> 


times BEP tried for recovery 


_ 
al 


busy timeouts 
times disk sync not attained 


selector wait failures 
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fent (continued) 


fent command parameters and variables (continued) 


Parameters 
and variables Description 


disk clock failures 


reseek during recovery procedures 


seek faults 

drive faults 

head switches during recovery procedures 
commands rejected by disk 

times BEP failed to recover data 


sector pulse dropouts 


Qualifications 
The fent command is qualified by the following exceptions, restrictions, and 
limitations: 


e The fent command is not a part of routine maintenance activities. 


e The fent command is normally used as an aid to isolating difficulties on 
the disk system during debugging procedures. 


Example 
The following table provides an example of the fent command. 


Examples of the fent command 


Example Task, response, and explanation 


fent 18 J 
where 


18 is the disk controller firmware counter to be displayed 


Task: Display the disk clock failure disk controller firmware counter. 


Response: 18.# Disk clock failures 


Explanation: The counter is displayed. 
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DDU level commands D-309 
fent (end) 


Responses 


The following table provides explanations of the responses to the fent 
command. 


Responses for the fent command 


MAP output Meaning and action 


+ 1= 1022 # 2= 
# 6= 0 + 7= 
#11= 72 #12= 
#16= 0 #17= 
#21= 0 #22= 


Meaning: All the firmware counters are displayed. 


Action: None 


18.# Disk clock failures 


Meaning: The requested firmware counter is displayed. Each individual firmware 
counter is displayed by number and name. 


Action: None 
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listdev 


Function 


Use the listdev command to display the status of a specified device 
connected to a specified input/output controller (IOC) card. 


listdev command parameters and variables 
Command Parameters and variables 
listdev device_type 


Parameters 
and variables Description 


ddu This parameter identifies the device to be listed as a DDU. When only the DDU p4 
rameter is entered all the DDUs are listed in response. 


device_type This variable is the device type to be listed. Valid entries are nx25, dic, cons, dpat 
mtc, ddu, and mpc. 


This variable identifies the number of a specific IOC card. Valid entries are 0-19. 


Qualifications 


The listdev command is qualified by the following exceptions, restrictions 
and limitations: 


e The display is limited to only those devices of the specified type attached 
to the specified IOC. 


e When more than one device is connected to the same card the command 
listdev displays only the information for the device on port 0. 
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listdev (continued) 


Examples 


The following table provides an example of the listdev command. 


Examples of the listdev command 


Example 


Task, response, and explanation 


listdev 1 ddu J 


where 


1 is the number of the IOC card connected to the devices 


Responses 


Task: List DDU 1. 


Response: DDU USER STATUS IOC CARD PORT Drive_State 
1 system Ready 1 0 0 on_line 


Explanation: The response lists the requested DDU. 


The following table describes the meaning and significance of each portion 
of possible responses to the listdev command and examples of full 
responses. 


Responses for the listdev command 


MAP output 


Meaning and action 


Meaning: Identifies the card position within the IOC occupied by the DDU. 


Action: None 


Meaning: This column echoes the device specified and provides the number of 
each device. 


Action: None 
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DDU level commands D-313 
listdev (continued) 


Responses for the listdev command (continued) 


MAP output Meaning and action 


DDU USER STATUS IOC CARD PORT Drive _State 
system Ready on_line 
system Ready on_line 
system Ready on_line 


Meaning: This is an example of a full display, in response to the listdev command 
with the DDU parameter. 


Action: None 


USER STATUS IOC CARD PORT Drive_State 
system Ready 1 0 0 on_line 


Meaning: This is an example of a full display, in response to the listdev command 
with the IOC number variable and the DDU parameter. 


Action: None 


INVALID 
Card unknown 


Meaning: A listdev display cannot occur. Possible reasons for the command to be 
invalid are because the card is unknown, the card is of an unknown type, 
or no device exists for the device specified. 


Action: None 


Meaning: Identifies the IOC number to which the DDU is connected. 


Action: None 


Meaning: Identifies the port on the card to which the DDU connection is 
configured. 


Action: None 
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D-314 DDU level commands 
listdev (end) 


Responses for the listdev command (continued) 


MAP output Meaning and action 


STATUS 
Offl 


Meaning: Provides the status of the device. 


Action: None 


USER 
SYSTEM 


Meaning: Displays the field value specific to the relevant device. DDU displays 
system as the user. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DDU level commands D-315 
offl 


Function 
Use the offl command to change the status of the disk controller to offline. 


offl command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 


The offl command is qualified by the following exceptions, restrictions, and 
limitations: 


e The controller must be manually busy before it can be put into the offline 
state. 


e The drive must be stopped before the DDU can be taken offline. 


Examples 
The following table provides an example of the offl command. 


Examples of the offl command 


Example Task, response, and explanation 


Task: Take the DDU offline. 


Response: OK 


Explanation: The DDU is offline. 
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D-316 DDU level commands 
offl (end) 


Responses 
The following table provides explanations of the responses to the offl 


command. 


Responses for the offl command 


MAP output Meaning and action 


Invalid 
DEVICE DDU 0 is inservice. 


Meaning: The DDU is in service. 


Action: Use the bsy command to make the DDU manually busy, then retry the 
offl command. 


Invalid 
DEVICE DDU 0 is offline. 


Meaning: The DDU is already offline. 


Action: None 


Meaning: The DDU is offline. 


Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for 
incrname are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current 
level. The range of retreat levels is 0-6. However, the system cannot accept a 
level number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DDU level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DDU level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DDU level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DDU level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DDU level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DDU level commands D-319 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DDU level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 
Use the rts command to test the DDU and return it to service. 


rts command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 


The rts command is qualified by the following restriction: the DDU must be 
in the manually-busy or system-busy state to be returned to service. 


Example 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


Task: Test the DDU and return it to service. 
Response: OK 


Explanation: The DDU passed the test and is returned to service. 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


Meaning: The DDU is returned to service. 


Action: None 
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rts (end) 


Responses for the rts command (continued) 


MAP output Meaning and action 


RTS process may take up to 3 minutes. 
Failed 
Drive is disconnected. 


Meaning: The DDU is disconnected and cannot be returned to service. 


Action: None 


RTS process may take up to 3 minutes. 
Invalid 
Device DDU 0 is offline. 


Meaning: The DDU is offline. 


Action: Use the bsy command to make the DDU manually busy, then retry the 
rts command. 


RTS process may take up to 3 minutes. 
Invalid 
Device DDU 0 is in service. 


Meaning: The DDU is already in service. 


Action: None 


RTS process may take up to 3 minutes. 
OK 


Meaning: The system displays a warning that the RTS process may be delayed by 
the specified amout of time. The DDU is returned to service. 


Action: None 
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status 


Function 


Use the status command to display information concerning the controller 
and the disk drives. 


status command parameters and variables 


Command Parameters and variables 


status There are no parameters or variables. 


Qualifications 


The status command is qualified by the following exceptions, restrictions, 
and limitations: 


e The display generated by this command is not dynamically updated if 
changes occur. The status at the time the command is issued displays. 


e The most recent status can be generated by issuing the status command 
again. 


Example 
The following table provides an example of the status command. 


Example of the status command 


Example Task, response, and explanation 
status | 


Task: Display the status of the controller and disk drives. 


Response: Status 
DDU 3 

is Manual Busy 

Drive is stopped 


Explanation: The requested information is displayed. 
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status (end) 


Response 


The following table provides an explanation of the response to the status 
command. 


Response for the status command 


MAP output Meaning and action 


DDU 3 
is Manual Busy 
Drive is stopped 


Meaning: The status of the controller and the drives displays. Following are the 
possible states of the drive: 


added but not allocated-the drive is identified in table DDU but no 
volumes have been defined on it, or since the unit has not been put 
in service, the allocation chart has not been read by the system 


allocated and spun up-volumes have been allocated on the drive, 
and it is ready for use 


being allocated-the allocation process is currently being performed 
on the DDU 


disconnected-the drive is physically disconnected, or the power 
converter needs to be reset 


not OK has drive faults-there are faults on the drive 
online-the drive is spinning and in service with no faults 
spinning-the drive is spinning 

stopped-the drive is not rotating 


Action: None 
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start 


Function 
Use the start command to start spinning the disk drive. 


start command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualification 
The start command is qualified by the following restriction: the disk drive 
must be in the manually busy state to be started. 


Example 
The following table provides an example of the start command. 


Example of the start command 
Example Task, response, and explanation 
start 


Task: Start the disk drive spinning. 
Response: Disk start successful. 


Explanation: The disk drive has begun spinning. 


Responses 


The following table provides explanations of the responses to the start 
command. 


Responses for the start command 


MAP output Meaning and action 


Command not allowed: Controller not busied. 


Meaning: The DDU must be manually busied to start. 


Action: Use the bsy command to manually busy the DDU, then retry the start 
command. 
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start (end) 


Responses for the start command (continued) 
MAP output Meaning and action 
Disk start successful 
Meaning: The disk drive has begun spinning. 


Action: None 


Process may take up to 75 Seconds. 
Disk start unsuccessful 


Meaning: The disk drive could not be started. 


Action: None 
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stop 


Function 
Use the stop command to stop the rotation of the disk drive. 


stop command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualification 
The stop command is qualified by the following restriction: the DDU must 
be manually busy before the stop command is issued. 


Example 
The following table provides an example of the stop command. 


Example of the stop command 


Example Task, response, and explanation 


Task: Stop the rotation of the disk drive. 
Response: Disk stop successful 


Explanation: The disk drive is stopped. 


Responses 


The following table provides explanations of the responses to the stop 
command. 


Responses for the stop command 
MAP output Meaning and action 


Command not allowed: Controller not MBSY. 


Meaning: The DDU must be manually busied to be stopped. 


Action: Use the bsy command to manually busy the DDU, then retry the stop 
command. 
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D-328 DDU level commands 
stop (end) 


Responses for the stop command (continued) 


MAP output Meaning and action 


Disk stop successful 


Meaning: The disk is stopped. 


Action: None 
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DDU level commands D-329 
tst 
Function 


Use the tst command to test the disk controller and disk drive. 


tst command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 


The tst command is qualified by the following exceptions, restrictions, and 
limitations: 


e The tst command can be used then the DDU is in-service or 
out-of-service. The scope of the test performed is determined by the 


state of the DDU. 
e When the DDU is in-service, the following tests are performed: 

- reset controller sequence test checks the random-access memory 
(RAM) store of the controller 

- loopback message test sends a message to and receives a 
reply from the controller 

- drive status test determines the current status of the 
DDU 


e When the DDU is in the system-busy or manually-busy state, all the 
in-service tests are performed and the following tests are added: 


- spin test attempts to spin the drive up to speed if it is stopped 
- read-only test reads the particular location of each volume 


- write-only test writes information in a single reserved area on the 
DDU 
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D-330 DDU level commands 
tst (end) 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


Task: Test the DDU. 
Response: OK 


Explanation: The DDU passed the tests. 


Responses 


The following table provides explanations of the responses to the tst 
command. 


Responses for the tst command 


MAP output Meaning and action 


Invalid 
Device DDU 0 is offline. 


Meaning: The DDU must be either in-service or busied to be tested. 


Action: Use the bsy command to make the DDU manually busy, then retry the 
tst command. 


Meaning: The DDU passed the tests. 


Action: None 


Process may take up to 3 Minutes. 
OK 


Meaning: The DDU passed the tests. 


Action: None 
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D-331 


DELAYS (LGC) level commands 


Use the DELAYS (LGC) level of the MAP to obtain information on call 
processing delays. 


Accessing the DELAYS (LGC) level 
To access the DELAYS (LGC) level, enter the following from the CI level: 
mapci;mtc;pm;pm_type;perform;delays — 


where 
pm_type is one of the following PM types: LGC, LTC, DTC, RCC, or 
RCCI 
DELAYS (LGC) commands 


The commands available at the DELAYS (LGC) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DELAYS (LGC) commands 


Command 
quit 

stop 
stoplog 


strt 


strtlog 
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D-332 DELAYS (LGC) level commands 


DELAYS (LGC) menu 
The following figure shows the DELAYS (LGC) menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
Delays 
0 Quit 
2 SELE 
3 Strtlog 
4 Stoplog 
5 Stop 
6 
7 Load Name: NLG24BK 
8 STATUS: STOPPED REASON:NO START LOGS:OFF TIME:00:00:00 
9 
10 Dialtone Post PCM 
17 Dialtone Removal Dialing Cutthrough 
12 DP DT DP DT DP DT Answer Speech_path 
13 Avg 50? “Ss = = 
14 50% == = = 
15 95% = 7 = = 
16 
17 
18 
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DELAYS (LGC) levelcommands D-333 


DELAYS (LGC) status codes 
The following table describes the status codes for the DELAYS (LGC) status 
display. 


Status codes DELAYS (LGC) menu status display 
Code Meaning Description 

Load Name Software Name of software load 

Status Status of PM 

Reason Reason for current status 


Logs Logs utility is on or off 


Time Not currently available 


Dialtone delay This is the period of time between when the peripheral sees the off-hoo 
to the time when dialtone is applied. It does not include the off-hook filte 
time in the LCM. Dialtone delay is subdivided into three categories: 
DP/EBS lines, DT lines, and UTR lines. 


Dialtone This is the time between when the peripheral sees the first digit until IDL 

Removal tone is applied and Dialtone is removed. This does includes any filtering 
in CSM for digits. The measurement is divided into three categories: 
DP/EBS lines, DT lines, and UTR lines. 


Post dialing This is the time between the last digit dialed until the application of audible 
delay ringing. Post dialing delay will be divided into three categories: DP/EB 
lines, DT lines, and UTR lines. 


PCM This is the combination of answer and speech_path and the time to 
Cutthrough connect speech path from the off-hook. 


Answer This is the time between the answer seen by the peripheral to the 
transmission of the off-hook to the originating end. 


Speech path This is the time from the off-hook seen by the originating party to the 
application of PCM (speech path) between the two parties. 


The data for each call processing delay is divided as follows: 


Avg Average 


50% 50 50 percent of all delays were less than this value. 
percentile 


95% 95 95 percent of all delays were less than this value. 
percentile 
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DELAYS (LGC) level commands D-335 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DELAYS (LGC) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DELAYS (LGC) level has changed to the previous menu level. 
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D-336 DELAYS (LGC) level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DELAYS (LGC) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DELAYS (LGC) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DELAYS (LGC) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DELAYS (LGC) level commands D-337 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DELAYS (LGC) level with the display of the next higher 
MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DELAYS (LGC) level commands D-339 
stop 


Function 


Use the stop command to stop the MAP level process within the peripheral 
module and the CC. Logs will be output if logs were on. 


stop command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Example 
The following table provides an example of the stop command. 


Example of the stop command 


Example Task, response, and explanation 


Task: 
Response: 


Load Name: NLG24BK 
STATUS: STOP_PEND REASON: COMMAND LOGS:OFF TIME: 
Dialtone Post 
Dialtone Removal Dialing Cutthrough 
DP DT DP DT DP DT ANSV SVPCM 
Avg 


Explanation: 
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DELAYS (LGC) level commands D-340 
stop (end) 


Responses 


The following table provides an explanation of the response to the stop 
command. 


Responses for the stop command 
MAP output Meaning and action 


STATUS: STOPPED REASON: COMMAND LOGS: OFF TIME: 00:00:00 


Meaning: The process within the peripheral and the CC. The status line is 
updated. If LOGS were ON, log information would be printed. 


Action: None 


RESPONSE STOP_PEND 


Meaning: This is displayed in the status field for any tool when the stop command 
is entered. At the next CC minute the state is changed to STOPPED. 


Action: None 
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stoplog 


Function 
Use the stoplog command to disable the output of logs. 


stoplog command parameters and variables 


Command Parameters and variables 


stoplog There are no parameters or variables. 


Qualifications 
None 


Example 
The following table provides an example of the stoplog command. 


Example of the stoplog command 
Example Task, response, and explanation 
stoplog - 

Task: Disable the output to logs. 


Response: (Not currently available) 


Explanation: Output to logs has been disabled. 


Responses 


Not currently available 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DELAYS (LGC) level commands D-343 
strt 


Function 
Use the strt command to start the time value. 


strt command parameters and variables 


Command Parameters and variables 
timeout 


Parameters 
and variables Description 


timeout This variable identifies the timeout value. The range is 1-1440. The default value 
is 15 minutes. 


Qualifications 
None 


Examples 
Not currently available 


Response 


The following table provides an explanation of the response to the strt 
command. 


Response for the strt command 


MAP output Meaning and action 


Load Name: <load_name> 
STATUS:<status> REASON:<reason> LOGS:<logs> TIME:<hh.mm.ss> 
Dialtone Post PCM 
Dialtone Removal Dialing Cutthrough 
DP DT DP DT DP DT Answer Speech_path 


Meaning: The screen is zeroed out. All zeros are represented by “-”. <Status> is 
updated to RUNNING. <Reason> is updated to COMMAND. <Logs> is 
not updated. <Time> is updated to the parameter selected or the default 
value of 15 minutes. 


Action: None 
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strtlog 
Function 


Use the strtlog command to enable logs to be generated for the performance 
process. 


strtlog command parameters and variables 


Command Parameters and variables 


strtlog There are no parameters or variables. 


Qualifications 
Not currently available 


Example 
The following table provides an example of the strtlog command. 


Examples of the strtlog command 
Example Task, response, and explanation 


strtlog 4- 


Task: Enable logs to be generated. 


Response: (Not currently available) 


Explanation: Log generating is enabled. 


Responses 


Not currently available 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-347 


DELAYS (RCC) level commands 


Use the DELAYS (RCC) level of the MAP to obtain information on call 
processing delays. 


Accessing the DELAYS (RCC) level 
To access the DELAYS (RCC) level, enter the following from the CI level: 
mapci;mtc;pm;pm_type;perform;delays — 


where 
pm_type is one of the following PM types: LGC, LTC, DTC, RCC, or 
RCCI 
DELAYS (RCC) commands 


The commands available at the DELAYS (RCC) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DELAYS (RCC) commands 


Command 
quit 

stop 
stoplog 


strt 


strtlog 
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D-348 DELAYS (RCC) level commands 


DELAYS (RCC) menu 
The following figure shows the DELAYS (RCC) menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
Delays 
0 Quit 
2 SELE 
3 Strtlog 
4 Stoplog 
5 Stop 
6 
7 Load Name: NLG24BK 
8 STATUS: STOPPED REASON:NO START LOGS:OFF TIME:00:00:00 
9 
10 Dialtone Post PCM 
17 Dialtone Removal Dialing Cutthrough 
12 DP DT DP DT DP DT Answer Speech_path 
13 Avg 50? “Ss = = 
14 50% == = = 
15 95% = 7 = = 
16 
17 
18 
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DELAYS (RCC) level commands D-349 


DELAYS (RCC) status codes 
The following table describes the status codes for the DELAYS (RCC) status 
display. 


Status codes DELAYS (RCC) menu status display 
Code Meaning Description 

Load Name Software Name of software load 

Status Status of PM 

Reason Reason for current status 


Logs Logs utility is on or off 


Time Not currently available 


Dialtone delay This is the period of time between when the peripheral sees the off-hoo 
to the time when dialtone is applied. It does not include the off-hook filte 
time in the LCM. Dialtone delay is subdivided into three categories: 
DP/EBS lines, DT lines, and UTR lines. 


Dialtone This is the time between when the peripheral sees the first digit until IDL 

Removal tone is applied and Dialtone is removed. This does includes any filtering 
in CSM for digits. The measurement is divided into three categories: 
DP/EBS lines, DT lines, and UTR lines. 


Post dialing This is the time between the last digit dialed until the application of audible 
delay ringing. Post dialing delay will be divided into three categories: DP/EB 
lines, DT lines, and UTR lines. 


PCM This is the combination of answer and speech_path and the time to 
Cutthrough connect speech path from the off-hook. 


Answer This is the time between the answer seen by the peripheral to the 
transmission of the off-hook to the originating end. 


Speech path This is the time from the off-hook seen by the originating party to the 
application of PCM (speech path) between the two parties. 


The data for each call processing delay is divided as follows: 


Avg Average 


50% 50 50 percent of all delays were less than this value. 
percentile 


95% 95 95 percent of all delays were less than this value. 
percentile 
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DELAYS (RCC) level commands D-351 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DELAYS (RCC) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DELAYS (RCC) level has changed to the previous menu level. 
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D-352 DELAYS (RCC) level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DELAYS (RCC) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DELAYS (RCC) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 
Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DELAYS (RCC) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DELAYS (RCC) level commands D-353 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display ofthe DELAYS (RCC) level with the display of the next higher 
MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DELAYS (RCC) level commands D-355 
stop 


Function 


Use the stop command to stop the MAP level process within the peripheral 
module (PM) and the CC. Logs will be output if logs were on. 


stop command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Example 
The following table provides an example of the stop command. 


Example of the stop command 


Example Task, response, and explanation 


Task: Use the command to stop the MAP level process within the PM 
and the CC. 


Response: 


Load Name: NLG24BK 
STATUS: STOP_PEND REASON: COMMAND LOGS:OFF TIME: 
Dialtone Post 
Dialtone Removal Dialing Cutthrough 
DP DT DP DT DP DT ANSV SVPCM 
Avg 


Explanation: The command has stopped the MAP level process within the PM 
and the CC. 
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DELAYS (RCC) level commands D-356 
stop (end) 


Responses 


The following table provides an explanation of the responses to the stop 
command. 


Responses for the stop command 
MAP output Meaning and action 


STATUS: STOPPED REASON: COMMAND LOGS: OFF TIME: 00:00:00 


Meaning: The process within the PM and the CC. The status line is updated. If 
LOGS were ON, log information would be printed. 


Action: None 


RESPONSE STOP_PEND 


Meaning: This is displayed in the status field for any tool when the stop command 
is entered. At the next CC minute the state is changed to STOPPED. 


Action: None 
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stoplog 


Function 
Use the stoplog command to disable the output of logs. 


stoplog command parameters and variables 


Command Parameters and variables 


stoplog There are no parameters or variables. 


Qualifications 
Not currently available 


Example 
The following table provides an example of the stoplog command. 


Example of the stoplog command 
Example Task, response, and explanation 
stoplog - 

Task: Disable the output to logs. 


Response: (Not currently available) 


Explanation: Output to logs has been disabled. 


Responses 


Not currently available 
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DELAYS (RCC) level commands D-359 
strt 


Function 
Use the strt command to start the time value. 


strt command parameters and variables 


Command Parameters and variables 
timeout 


Parameters 
and variables Description 


timeout This variable identified the timeout value. The range is 1-1440. The default value 
is 15 minutes. 


Qualifications 
None 


Examples 
Not currently available 


Response 


The following table provides an explanation of the response to the strt 
command. 


Response for the strt command 


MAP output Meaning and action 


Load Name: <load_name> 
STATUS:<status> REASON:<reason> LOGS:<logs> TIME:<hh.mm.ss> 
Dialtone Post PCM 
Dialtone Removal Dialing Cutthrough 
DP DT DP DT DP DT Answer Speech_path 


Meaning: The screen is zeroed out. All zeros are represented by “-”. <Status> is 
updated to RUNNING. <Reason> is updated to COMMAND. <Logs> is 
not updated. <Time> is updated to the parameter selected or the default 
value of 15 minutes. 


Action: None 
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strtlog 
Function 


Use the strtlog command to enable logs to be generated for the performance 
process. 


strtlog command parameters and variables 


Command Parameters and variables 


strtlog There are no parameters or variables. 


Qualifications 
Not currently available 


Example 
The following table provides an example of the strtlog command. 


Examples of the strtlog command 
Example Task, response, and explanation 


strtlog 4- 


Task: Enable logs to be generated. 


Response: (Not currently available) 


Explanation: Log generating is enabled. 


Responses 


Not currently available 
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D-363 


DEVICES (CFI) level commands 


Use the DEVICES (CFD) level of the MAP to obtain information about and 
perform maintenance functions on a channel frame interface (CFI). 


Accessing the DEVICES (CFI) level 
To access the DEVICES (CFI) level, enter the following from the CI level: 
mapci;mtc;pm;post CFI cfi_no;devices .. 


where 


cfi_no is the number of the CFI to be posted. 


DEVICES (CFI) commands 


The commands available at the DEVICES (CFI) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DEVICES (CFI) commands 


Command 
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D-364 DEVICES (CFI) level commands 


DEVICES (CFI) commands (continued) 


Command 


DEVICES (CFI) menu 


The following figure shows the DEVICES (CFI) menu and status display. 
The insert with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 


Device SysB ManB Offl Cbsy ISTb InSv 
0 Quit PM 0 0 0 0 2 8 
2 Post_ CFI 0 0 0 - 1 t 
3 
4 CFI 0: DS3 Trunks IsTb (NA) /Mtce 
5 Trnsl_ 
6 Tst_ Act Status 
7 Bsy_ Unit 0 A  InSv (NA) RexFlt 
8 RTS_ Unit 1 I ManB /Mtc /Loadint: 200 
9 Off1_ 
10 Msg-Chan Net-Link MS-Link 
11 Disp_ 0O 1 CFI 
12 Next Unit 0 4 . FPBO. 
13 SwAct_ Unit VP). = % . FPB1. 
14 QueryDV_ 


Hidden commands 


abtk 


Common responses 


The following table provides explanations of the common responses to the 
DEVICES (CFI) commands. These responses will be produced by many of 
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DEVICES (CFI) level commands D-365 


the commands under the DEVICES (CFI) level. This table will be referred 
to from the individual command descriptions to which it pertains. 


Responses for the DEVICES (CFI) commands 


MAP output Meaning and action 


Command initiated. Expected completion within <n> 
Meaning: Maintenance has started executing. The action should be completed in 
time <n> where: 


<n> is s specified amount of time. 
Action: None 


Command aborted. No HOST links exist to node. 


Meaning: Although the node itself has been datafilled, no links connecting it to its 
C-side node have been data filled (or made known to node or link 
maintenance). 


Action: Provide link data information and reenter the command. 


Command aborted. No communication path open to the node 


Meaning: The node is not accessible because of error in links connecting it to the 
maintenance host. 


Action: Determine whether problems exist with the link hardware. If so, correct 
the problem and reenter the command. 


Command aborted. Node is not responding. 


Meaning: Although the node is accessible, it is not responding to the command 
request. It is possible that the CFI has not yet been loaded or that it is 
experiencing problems in its software or hardware that are preventing it 
from communicating properly. 


Determine whether problems exist with the load or in any of the node 
hardware. If so, correct the problem and reenter the command. If not, 
or if a software problem is suspected contact next level of maintenance 
support. 


Command aborted. Maintenance in progress on node. 


Meaning: Other maintenance actions are being executed on the node as indicated 
by the “/Mtce” flag on the unit's MAP display. 


Action: reenter command when the “/Mtce” flag on the units MAP display is 
removed. 
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D-366 DEVICES (CFI) level commands 


Responses for the DEVICES (CFI) commands (continued) 
MAP output Meaning and action 


All parameter may only be used in WAIT mode. 
Meaning: The ALL parameter was specified in one of two illegal situations: 


the Cl session is in nonwait mode 
the user specified a nowait parameter with the command 
Action: reenter the command using the using the wait parameter 


WAIT mode not available. Execute command in no-WAIT mode? 


Meaning: The session is in wait mode, but a lack of system resources prevents the 
required messaging interactions from occurring. The user is therefore 


prompted to determine if the command can be executed in the nowait 
mode. 


Action: If willing to execute the command in the nowait mode respond by 
entering, “yes,” otherwise enter, “no.” 


Messaging currently unavailable with “ALL” parameter. 


Meaning: Alack of system resources prevents the required messaging interactions 
from occurring. The command is aborted. 


Action: The session should be placed into nowait mode, then the command 
should be reentered for all nodes in the post set. 


Command aborted. External abort received by maintenance. 


Meaning: command request has be terminated by the MAP abtk command. 
Action: None 


Command aborted. Software inconsistency. 


Meaning: Software received an unexpected return code or condition at some time 


during the command execution. A SWERR log is produced and the 
command is terminated. 


Action: This problem can only be fixed with t software update. Collect SERRS 
and other logs produced and submit them to technical support. 
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abtk 


Function 


Use the abtk command to abort maintenance action currently running on the 
posted CFI. 


abtk command parameters and variables 


Command Parameters and variables 


cfi unit_num prompt wait reply 
msgch unit_num ms_num noprompt || nowait noreply 
netlink fob_num 

mslink 

fpb 


Parameters 
and variables Description 


This parameter causes the task for the CFI to be aborted. 


This parameter causes the task for the DS-512 paddle board to be aborted. 


This variable is number of the DS-512 paddle board and has a range of 0-1. 

This parameter causes the task for the message channels to be aborted. 

This parameter causes the task for the MS link to be aborted. 

This variable is number of the message channel and has a range of 0-1. 

This parameter causes the task for the ENET link to be aborted. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the abtk command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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D-368 DEVICES (CFI) level commands 
abtk (continued) 


abtk command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
None 


Example 
The following table provides an example of the abtk command. 


Example of the abtk command 


Example Task, response, and explanation 


abtk CFI 1 
where 


1 is the number of the CFI unit 


Task: Abort any maintenance task currently running of CFI unit 1. 


Response: AbTk 


Explanation: The current task running of CFI unit 1 is aborted. 
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abtk (end) 
Responses 


The following table provides explanations of the responses to the abtk 
command. 


Responses for the abtk command 
MAP output Meaning and action 
Command identifier for AbTk command is “AbTk”. 


Meaning: The task currently executing on the specified component has been 
aborted. 


Action: None 
Command failed. Current task could not be aborted. 


Meaning: The task currently executing on the specified component could not be 
aborted. 


Action: None 


Command aborted. No task to abort. 


Meaning: No maintenance task is currently executing on the specified component. 


Action: None 
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bsy 


Function 


Use the bsy command to place the card or link on the posted CFI in the 
manual busy (ManB) state. 


bsy command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
netlink fpb_num noprompt || nowait noreply 
mslink 

fpb 


bsy noforce 
(continued) force 


Parameters 
and variables Description 


This parameter causes the DS-512 paddle board to be busied. 


This parameter will force an ISTb component to be busied immediately without 
waiting for current tasks to be completed. 


This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes the message channels to be busied. 
This parameter causes the MS link to be busied. 


This variable is number of the message channel and has a range of 0-1. 


This default parameter, which is never entered, indicates that component will not 
be forced to the busy state immediately because the force parameter is not enterep. 


This parameter causes the ENET link to be busied. 


This parameter prevents all prompting. 


This parameter suppresses all responses to the command action. 
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bsy (continued) 


bsy command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 
wait This default parameter, which is never entered, indicates that additional command 


cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The force parameter forces all work currently in progress on the unit to 
terminate immediately. Normally, work in progress continues to completion 
before the unit is made busy. The force parameter should only be sued when 
a rapid shutdown of the unit hardware is required. 


Example 
The following table provides an example of the bsy command. 


Example of the bsy command 


Example Task, response, and explanation 


bsy netlink 1 — 
where 


1 is the number of the the DS-512 paddle board to be busied. 


Task: Busy DS-512 paddle board number 1 in the posted CFI. 


Response: Command successful. Component has been manually 
busied. 


Explanation: The bsy command is successful. 
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bsy (end) 


Responses 


The following table provides explanations of the responses to the bsy 
command. 


Responses for the bsy command 


MAP output Meaning and action 


WARNING: 
The FORCE option should only be used when a fast shutdown of the hardware 
is desired. All work in progress will be terminated. Please confirm 
(“YES” or SNO”) 7 

Meaning: The FORCE option must be verified. 

Action: Enter “YES” to continue the bsy command or“NO” to stop it. 


Command aborted. Busying link will isolate node. 


Meaning: If the specified message link is busied, the posted CFI will be isolated 
because the other message link is not available. 


Action: None 
Command successful. Component has been manually busied. 
Meaning: Bsy command is successful 


Action: None 


Command failed. Unit must be in-service or system-busy. 


Meaning: Unit cannot be manually busied unless it is either InSv or SysB. 


Action: None 
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disp 


Function 
The disp command is not implemented for the DEVICES (CFI) level. 
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DEVICES (CFI) level commands D-377 
idmtce 
Function 


Use the idmtce command to turn the LED on the specified card of the posted 
CFI on or off. 


idmtce command parameters and variables 


Command Parameters and variables 


idmtce i unit_num on prompt wait reply 
fob_num off noprompt| | nowait noreply 


Parameters 
and variables Description 


This parameter selects the CFI. 

This parameter causes the DS-512 paddle board to be selected. 

This variable is number of the DS-512 paddle board and has a range of 0-1. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter causes the LED to be turned off. 
This parameter causes the LED to be turned on. 


This default parameter, which is never entered, indicates that prompts will be issue 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered atthe MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


Because LEDs can be used to identify cards which should be pulled, the user 
will be prompted for verification before the command will be continued. 
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D-378 DEVICES (CFI) level commands 
idmtce (continued) 


Example 
The following table provides an example of the idmtce command. 


Example of the idmtce command 


Example Task, response, and explanation 


idmtce cfi 0 on J 
where 


0 is the CFI unit number. 
Task: Turn the LED of CFI unit 0 on. 
Response: Command successful. LED turned ON. 


Explanation: The LED of CFI unit 0 is on. 


Responses 


The following table provides explanations of the responses to the idmtce 
command. 


Responses for the idmtce command 


MAP output Meaning and action 


Command aborted. LED is already ON. (or OFF) 


Meaning: The command is not executed because the LED is already in the 
requested state. 


Action: None 


Command successful. LED turned ON. (or OFF 


Meaning: The LED of selected CFI unit is in the selected state. 


Action: None 
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idmtce (end) 


Responses for the idmtce command (continued) 
MAP output Meaning and action 
WARNING: 


The specified card is active. 
Please confirm (“yes” or “NO”). 


Meaning: The card is active and since LEDs are sometimes used to identify cards 


that require replacement, the user must confirm that the command ought 
to continue. 


Action: Respons with “yes” to turn the LED on, or “no” to abort the command. 
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next 


Function 


Use the next command to place the next PM of the posted set into the 
control position. 


next command parameters and variables 


Command Parameters and variables 
pm_type 


Parameters 
and variables Description 


This parameter enables the system to select one PM type. Use the disp command 
to display the list of PM types in the posted set. The system selects the PMs in the 
sequence displayed by this list. 


Qualifications 


The next command is qualified by the following exceptions, restrictions, and 
limitations: 


e To use the next command, several CFIs must be posted to create a set. 


e The posted CFI number in all displays increases by one. Also, 
parameters used in the command post change (such as pm_state), if they 
are different from those for the previously posted CFIs. 


e Command next does not return to the top of the displayed set of CFIs. 


Examples 
Not currently available 


Response 


The following table describes the meaning and significance of the response 
to the next command. 


Response for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The last member of a displayed set is currently posted. 


Action: None 
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offl 


Function 
Use the offl command to put a CFI card in the offline state. 


offl command parameters and variables 


Command Parameters and variables 


netlink fob_num prompt wait reply 
mslink noprompt| | nowait noreply 
fpb 


Parameters 
and variables Description 


This parameter causes the DS-512 paddle board to be offlined. 

This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes the MS link to be offlined. 

This parameter causes the ENET link to be offlined. 


This parameter prevents all prompting and defaults all answers to prompts to yes. 


This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issue 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The card must be in the ManB state before the offl command can be used. 
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D-384 DEVICES (CFI) level commands 
offl (continued) 


Example 
The following table provides an example of the offl command. 


Examples of the offl command 


Example Task, response, and explanation 


offi mslink 0 
where 


0 is the number of the DS-512 paddle board. 
Task: Place the DS-512 paddle board o of the posted CFI offline. 


Response: Command successful. Card has been placed in the 
offline state. 


Explanation: The card is offline. 


Responses 
The following table provides explanations of the responses to the offl 


command. 


Responses for the offl command 


MAP output Meaning and action 


Command aborted. Card must be manually busy before it can be taken 
offline. 


Meaning: The card cannot be taken offline until it has been placed in the manual 
busy state. 


Action: None 


Command aborted. DFI would be isolated. 


Meaning: The command would leave both DS-512 paddle board in an offline state. 
This would isolate the CFI. 


Action: None 
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offl (end) 


Responses for the offl command (continued) 
MAP output Meaning and action 
Command aborted. Card is already offline. 


Meaning: No need to execute the command as the card was already in the offline 
state. 


Action: None 


Command successful. Card has been placed in an offline state. 


Meaning: The card has been successfully taken offline. 


Action: None 
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post 


Function 
Use the post command to select a specific CFI upon which action is to be 
performed by other commands. The post command must be used before 
entering commands swrg, trnsl, tst, bsy, rts, offl, loadpm, or querypm. 


post command parameters and variables 


Command Parameters and variables 


all pms 
site 
frame 
pm_state 


pm_type all 
pm_number...pm_number 


Parameters 
and variables Description 


allpms This parameter posts all PM types. 


site This variable posts all PM types at the site, where site is a four-character 
alphanumeric string. 


frame This parameter posts all PM types within the specified frame. The range is 0 to 99. 
pm-state This variable specifies a state and all pms in that state will be posted. 


pm_type This variable identifies the type of PM to be posted, which is the CFI. If the CFI 
PM level is already accessed, the pm_type may be omitted. 


all This parameter specifies that all CFI be posted. 
pm_number This variable specifies which CFI is to be posted. The range is 0 to 127. More than 


one CFI is posted by entering their discrimination numbers separated by a blank 
space. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 


limitations. 
e An CFI cannot be posted if it is not listed in Table LTCINV and 
LTCPSINV. 


e CFIs appear as a group on the display. From this group, specific CFIs 
may be posted by number. 
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D-388 DEVICES (CFI) level commands 
post (continued) 


Example 


The post command displays vary depending on the PM type and the PM 
set. 


If parameters cfi or allpms is entered alone with the post command, the 
menu commands on the new display level are used to select specific PM 
numbers. 


A list of current PM types and their discrimination number ranges can be 
displayed by entering the command disp. 


When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs that are present in the office configuration. For parameters that do 
not apply, one of several responses indicates that it is ignored. 


The following table provides an example of the post command. 


Example of the post command 


Example Task, response, and explanation 


post cfi all 


Task: Post all CFls 


Response: <Display for first CFI> 


Explanation:All CFls are posted. 
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post (end) 


Responses 


The following table provides explanations of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


NO PM POSTED 


Meaning: The CFI level is accessed without posting a specific CFI. 


Action: None 


pm_type x INSV LINKS_OOS: CSIDE y PSIDE z 
UNIT 0: activity state 
UNIT 1: activity state MCTE 


Meaning: The status of the posted CFI is displayed below the PM status display, 
where: 


pm_type is CFI for the type of PM. 
x is the discrimination number of the PM type. 
y is the quantity of C-side links that are out-of-service. 
Z is the number of P-side that are out-of-service. 
activity is the activity of each unit, where: 
ACT _ is for an active unit, that is, actually 
processing calls 
INACT is for an inactive unit, that is, on standby for 
the active unit 
state is one of the PM states listed and described In Table C 
on page 67. 
MTCE appears when a unit is undergoing maintenance actions 
(invoked manually or by the system). 


Action: None 
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querydv 


Function 


Use the querydv command to display specified information about the 
components of the CFI. 


querydv command parameters and variables 


Command Parameters and variables 


querydv cfi unit_num dfit wait reply 
fpb fob_num flt nowait noreply 

idprom 

msgch unit num ms num | afit l 


mslink 
acp 
location 


netlink ee | fit 


Parameters 
and variables Description 


This parameter selects all ACP nodes that are connected to the posted CFI. The 
information displayed includes the ACP RP type, RP number and slot number. 


This parameter causes the CFI to be queried. 


This default parameter, which is never entered, indicates that the standard 
information will be displayed because neither the flt or idprom parameters are 
entered. 


This parameter causes the DS-512 paddle board to be queried. 

This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes fault information to be displayed. 

This parameter causes IDPROM information to be displayed. 

This parameter causes the location of the queried component to be displayed. 
This parameter causes the message channels to be queried. 

This parameter causes the MS link to be queried. 


This variable is number of the message channel and has a range of 0-1. 
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D-392 DEVICES (CFI) level commands 
querydv (continued) 


querydv command parameters and variables (continued) 


Parameters 
and variables Description 


netlink This parameter causes the task for the ENET link to be aborted. 
noreply This parameter suppresses all responses to the command action. 


nowait This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


The querydv command is qualified by the following exceptions, restrictions, 
and limitations: 


e The default information is state information applying to the specified 
component. Although component states are constantly update, this 
command is still necessary to make state information available to users 
of paper terminals and MAP with the nodisp option. 


e Options can be used to see fault information for all components, and 
IDPROM information for cards. 


e If there are multiple faults for a card, the first fault description will be 
displayed, followed by its card list, then the next fault followed by its 
card list and so on. Faults are listed with the most critical faults 
appearing first. 
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querydv (continued) 


Examples 
The following table provides examples of the querydv command. 


Examples of the querydv command 


Example Task, response, and explanation 


querydv msgch 0 1. 
where 


0 is the unit number 
1 is the number of the message channel 


Task: Query the state of message channel unit O channel 1. 

Response: STATUS: INSV 

Explanation: Message channel unit O channel 1 is inservice. 
querydv cfi idprom J 

Task: Query idprom for CFI currently posted. 

Response: IDPROM read: idl IDPROM expected: id2 


Explanation: Discrepancy in expected and detected proms displayed. 


Responses 


The following table provides explanations of the responses to the querydv 
command. 


Responses for the querydv command 


MAP output Meaning and action 


Command aborted. Component is unequipped. 


Meaning: There is nothing to report as the specified component is not equipped. 


Action: None 
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D-394 DEVICES (CFI) level commands 
querydv (continued) 


Responses for the querydv command (continued) 


MAP output Meaning and action 


STATUS: <status> 


Meaning: The status of a card, link or message channel has been queried, and 
reported where: 


<status> is OFFL, MANB, SYSB, INSV, or ISTB. 
Action: None 


fault severity: card fault description 
<card_list> 


(for example) 


Non-critical fault: 3B error code detected. 
CFI:3 Floor:5 Row:bb Frame:7 shelf:2 slot:13f PEC:NTMX35AA 


Meaning: The flt parameter has been specified for a card. The information 
provided is as follows: 


fault severity no problem, noncritical or critical 
fault description a string describing the nature of the fault 


card list a list of possible faulty cards and their locations 
Action: None 


IDPROM read: idl IDPROM expected: id2 


Meaning: The idprom parameter was entered and the following information is 
provided: 


ACP: The type of ACP (LMX, PSP, HFT or others) 


Description ACP type, ACP number, slot, physical slot number, 
and system action. 
Action: None 
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querydv (end) 


Responses for the querydv command (continued) 


MAP output Meaning and action 


Description Floor Row Frame Shelf Slot PEC 

CFI Unit 0 87 AB 12 2 7F NTMX35AA 
CFI Unit 1 87 AB 12 8F NTMX35AA 
FPB 0 87 AB 12 7R NTMX3 9AA 
FPB 1 87 AB 12 8R NTMX3 9AA 


Meaning: The location of all devices for the posted CFI has been queried. 
Information is provided as follows: 


device: the type of device and RP number if applicable 


location: This consists of the fields, floor, row, frame, shelf, slot, 
anf PEC code. 
Action: None 
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DEVICES (CFI) level commands D-397 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DEVICES (CFI) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DEVICES (CFI) level has changed to the previous menu level. 
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D-398 DEVICES (CFI) level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DEVICES (CFI) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DEVICES (CFI) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DEVICES (CFI) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DEVICES (CFI) level with the display of the next higher 
MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 
Use the rts command to return to service a card or link on the posted CFI. 


rts command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
netlink fob_num noprompt || nowait noreply 
mslink 

fpb 


rts noforce 
(continued) force 


Parameters 
and variables Description 


This parameter causes the DS-512 paddle board to be returned to service. 


This parameter will force an ISTb component to be returned to service without 
testing. 


This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes the message channels to be returned to service. 


This parameter causes the MS link to be returned to service. 


This variable is number of the message channel and has a range of 0-1. 


This default parameter, which is never entered, indicates that testing will be 
performed on component before being returned to service because the force 
parameter is not entered. 


This parameter causes the ENET link to be aborted returned to service. 
This parameter prevents all prompting. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 
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rts (continued) 


rts command parameters and variables (continued) 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The component must be ManB or SysB before it can be returned to service. 


Example 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


rts msgch 0 1.1 
where 


0 is the unit number 
1 is the message channel number 


Task: Return message channel unit 0 channel 1 to service. 


Response: Command successful. Component has been returned 
to service. 


Explanation: The rts command successfully retuned the circuit to service. 
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rts (end) 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


WARNING: 
The FORCE option should only be used to RTS a component in the ISTb state 
(to avid testing). Please confirm (“YES” or “NO”). 


Meaning: The force parameter was entered with the RTS command. The system 
waits for response. 


Action: Enter yes to continue the command or no to terminate it. 
Command aborted. Component already inservice. 
Meaning: It is not possible to return to service a component already inservice. 
Action: None 
Command successful. Component has been returned to service. 
Meaning: Component has passed testing and been returned to service. 


Action: None 


Command successful. Component has been returned to in-service trouble. 


Meaning: The component failed testing but faults are not serious enough to affect 
service. 


Action: None 


Command failed. Failures occurred during component testing. 


Meaning: When an rts command is issued, diagnostics are performed on the 
component before returning it to service. Diagnostic failures have 
occurred and are reported. The errors are sever enough that the 
component cannot be returned to service. 


Take corrective maintenance action called for by indicated failure. 
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trnsl 


Function 


Use the trnsl command to identify the components in the path of the physical 
link connections to the ENET and MS and the message channel connections 
to the MS for the posted CFI node. 


trnsl command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num 


netlink fob_num 
mslink 


Parameters 
and variables Description 


fob_num This variable is number of the DS-512 paddle board and has a range of 0-1. 


msgch This parameter causes the message channels to be selected. 

mslink This parameter causes the MS link to be selected. 

ms_num This variable is number of the message channel and has a range of 0-1. 
netlink This parameter causes the ENET link to be selected. 


unit_num This variable is the number of the unit and has a range of 0-1. 


Qualifications 
None 
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trnsl (continued) 


Example 
The following table provides an example of the trnsl command. 


Examples of the trnsl command 


Example Task, response, and explanation 


trnsl msgch 0 1.1 
where 


0 is the CFI unit number 
1 is the message switch number 


Task: Display location information for the control message channel from 
CFI 0 to message switch 1. 


Response: FPB Description of MS links 
1 FPBO / MS 1, Shelf 0, Chain 18, Link 1 


Explanation: Information for the control message channel from CFI 0 to 
message switch 1 is displayed. 


Responses 


The following table provides explanations of the responses to the trnsl 
command. 


Responses for the trnsl command 


MAP output Meaning and action 


Unit MsgCh Description of Message Channels 
0 0 CFI 12, Unit 0 / MS 0, Shelf 0, Chain 1 
vis FPB 0, Link 1 
CFI 1 Unit 0 / MS 1, Shelf Chain 1 
FPB Link 1 
CFI 1 E 0%./ 0, Shelf Chain 1 
FPB Link 1 
CFI 1 it 0 / 0, Shelf Chain 1 
i FPB Link 1 


Meaning: This is response to a trnsl msgch command. The first line indicates that 
the control message channel from unit 0 of the CFI to MS 0 goes by FPB 
0 link 1 to MS 0, Shelf 0, card 18, Link 1, MPLH Port 3. 


Action: None 
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trnsl (end) 


Responses for the trnsl command (continued) 


MAP output Meaning and action 


FPB Description of Network Links 
O FPBO / ENET Plane 0, Shelf 1, 


Slot 11, Link 3 
1 FPBl / ENET Plane 1, Shelf 1, 


Slot 11, Link 3 


Meaning: This is the response to the trnsl netlink command. The Network link on 
fiber paddle board O terminates on ENET plane 0, shelf 1, slot 11 and 


link 3. The Network link on fiber paddle board 1 terminates on ENET 
plane 1 shelf 1, slot 11 and link 3. 


None 


FPB Description of MS links 
O FPBO / MS 0, Shelf 0, Chain 18, 


Link 1 
1 FPBO / MS 1, Shelf 0, Chain 18, 


Link 1 


Meaning: This is the response for the trnsl mslink command. The MS link on fiber 
paddle board 0 terminates on MS 0, plane 0, card 18, link 1. The MS 
link on fiber paddle board 1 terminates on MS 1, plane 0, card 18, link 1. 


Action: None 
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tst 


Function 
Use the tst command to test specified cards or links and display the results. 


tst command parameters and variables 


Command Parameters and variables 


cfi unit_num prompt wait reply 
msgch unit_num ms_num noprompt || nowait noreply 
netlink fob_num 

mslink 

fpb 


Parameters 
and variables Description 


This parameter causes the CFI to be tested. 

This parameter causes the DS-512 paddle board to be tested. 

This variable is number of the DS-512 paddle board and has a range of 0-1. 

This parameter causes the message channels to be tested. 

This parameter causes the MS link to be tested. 

This variable is number of the message channel and has a range of 0-1. 

This parameter causes the ENET link to be tested. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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tst (continued) 


tst command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The kind of tests that will be run is determined by wether the component is 
inservice or out-of-service. 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


tst msgch 0 1 
where 


0 is the CFI unit number 
1 is the message switch number 


Task: Test message switch number one on CFI unit 0. 


Response: Command passed. Component passed all tests. 


Explanation: The test of message switch number one on CFI unit 0 passed. 
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tst (end) 


Responses 


The following table provides explanations of the responses to the tst 
command. 


Responses for the tst command 


MAP output Meaning and action 


Specified card is unequipped. Card in slot will be tested anyway. 
Pleas confirm (“YES“ or “NO”). 


Meaning: The card to be tested is not equipped. The system waits for verification. 
Action: Totestthe unequipped card enter yes else enter no. 

Command aborted. Component already under test. 
Meaning: It is impossible to test a component already being tested. 


Action: None 


Command aborted. Component is offline. 


Meaning: A component must be on line to be tested. 


Action: None 
Command passed. Component passed all tests. 
Meaning: Test specified passed. 


Action: None 


Command failed. Component failed test. 


Meaning: The specified component failed a test issued against it. The reason for 
the failure is displayed. 


Action: None 
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swact (end) 


Function 
Use the swact command is not implemented at the DEVICES (CFI) level. 
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D-415 


DEVICES (FP) level commands 


Use the DEVICES (FP) level of the MAP to display status indicators of the 
file processor (FP) and to execute commands which produce these displays. 


Accessing the DEVICES (FP) level 
To access the DEVICES (FP) level, enter the following from the CI level: 
mapci;mtc;pm;post fp n;devices | 
where 


n is the number of the FP and has a range 0-99. 


DEVICES (FP) commands 


The commands available at the DEVICES (FP) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DEVICES (FP) commands 


Command 
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D-416 DEVICES (FP) level commands 


DEVICES (FP) menu 


The following figure shows the DEVICES (FP) menu and status display. 
The insert with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
2SysB 
DEVICES SysB ManB Offl Cbsy ISTb InSv 
0 Quit PM 2 0 0 0 2 8 
2 PostDEV_ FP 0 0 0 = 1 1 
FP 0: DataBase Plane Devices 
ISTb 
Tst_ 
Bsy_ CTRLO CTRL1 DEVICE 
RTS_ DABM 012345 
off1_ SCSI 0 ¿ (EN) : (DIS) Sch ie eS 
SCSI 1 4 (EN) 3 (DIS) = - 


QueryFP Hidden command 


SwEn 
abtk 


m 


m 
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DEVICES (FP) status codes 


The following table describes the status codes for the DEVICES (FP) status 
display. 


Status codes DEVICES (FP) menu status display 
Code Meaning Description 
The status of the dual access buffer memory (DABM) in the FP node. 
blank The DABM is unequipped. 
InSv The DABM is in-service and there are no faults. 
ISTb The DABM is in-service but a non-critical fault has been detected. 


The DABM is out-of-service due to one or more system detected 
critical faults. 


The DABM is under test. 
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Status codes DEVICES (FP) menu status display (continued) 


Code Meaning Description 


resource The DABM resource is busy due to a critical fault on the node or 
because the node is ManB, not because the DABM has a fault but 
because the node is system busy or manually busied. 


The SCSI indicator displays the status of the hardware associated with a single 
SCSI bus (SIP, SDIPs, DABM). 


blank SCSI is unequipped. 
InSv SCSI is in-service and there are no faults. 
ISTb SCSI is in-service but a non-critical fault has been detected. 


system SCSI is out-of-service due to one or more system detected critical 
faults. 


manual SCSI is out-of-service due to a manual busy action. 


system SCSI is out-of-service due to one or more system detected critical 
faults. 


test SCSI is under test. 


resource SCSI resource is busy due to a critical fault on the node or because the 
node is ManB, not because the SCSI has a fault but because the node 
is system busy or manually busied. 


blank Device is unequipped. 
InSv Device is in-service and there are no faults. 
ISTb Device is in-service but a non-critical fault has been detected. 


system Device is out-of-service due to one or more system detected critical 
faults. 


manual Device is out-of-service due to a manual busy action. 


system Device is out-of-service due to one or more system detected critical 
faults. 


test Device is under test. 


resource Device resource is busy due to a critical fault on the node or because 
the node is ManB, not because the Device has a fault but because the 
node is system busy or manually busied. 
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DEVICES (FP) level commands D-419 
abtk 


Function 
Use the abtk command to abort all active tasks on the posted device. 


abtk command parameters and variables 


Command Parameters and variables 


wait reply 
nowait noreply 


Parameters 
and variables Description 


This parameter inhibits all responses from the execution of the command. 


This parameter enables additional commands to be entered at a MAP terminal 
without waiting for the command to be completed. 


This default parameter, which is never entered, indicates that the command will 
produce MAP screen responses because the noreply parameter was not used. 


This default parameter, which is never entered, indicates that the user must wait 
until the command has completed executing before additional commands can be 
entered, because the nowait parameter was not used. 


Qualifications 


The abtk command is a hidden command, available at the DEVICES level, 
but not seen in the menu. 


Example 
The following table provides an example of the abtk command. 


Example of the abtk command 


Example Task, response, and explanation 


Task: Abort all current tasks on the posted device. 


Response: Command passed 


Explanation: All active tasks are aborted. 
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D-420 DEVICES (FP) level commands 
abtk (end) 


Responses 


The following table provides explanations of the responses to the abtk 
command. 


Responses for the abtk command 


MAP output Meaning and action 


Command failed. The PM is not responding. 


Meaning: Abort task has failed either because FP maintenance did not receive the 
request, or it did not respond to it. 


Action: None 
Request has been submitted. 
Meaning: The FP has just received the request. 


Action: None 


Command passed. 


Meaning: Abort task request is complete with no failures. 


Action: None 
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bsy 


Function 


Use the bsy command to busy specified devices or small computer systems 
interface (SCSI) busses and display the results. 


bsy command parameters and variables 


Command Parameters and variables 


scsi num dev_num prompt wait roly 
all noprompt || nowait noreply 


ctrl, num scsi_num 
ctrl_ num 


Parameters 
and variables Description 


This parameter indicates the user wants to busy all devices on an FP node. 


This parameter indicates the user wants to bsy all SCSI busses associated with the 
controller (CTRL). 


This variable specifies a controller and has a range of 0-1. 


This parameter indicates the user wants to busy one or more devices on an FP 
node. 


This variable specifies a device and has a range of 0-5. 


This parameter inhibits all prompts and causes the command to execute as thoug 
all prompt responses were, “yes.” 


This parameter inhibits all responses from the execution of the command. 


This parameter enables additional commands to be entered at a MAP terminal 
without waiting for the command to be completed. 


This default parameter, which is never entered, indicates that the command 
provides prompts because the noprompt parameter was not used. 


This default parameter, which is never entered, indicates that the command 
produces MAP screen responses because the noresponse parameter was not 
used. 
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bsy (continued) 


bsy command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter indicates the user wants to busy a particular set of SCSI bus 
hardware, such as will SCSI interface paddleboard (SIP), storage device interfacd 
paddleboards (SDIP), dual access buffer memory (DABM), on a controller. 


This variable SCSI hardware and has a range of 0-1. 


This default parameter, which is never entered, indicates that the user must wait 
until the command has completed executing before additional commands can be 
entered, because the nowait parameter was not used. 


Qualifications 
None 


Examples 
The following table provides examples of the bsy command. 


Examples of the bsy command 


Example Task, response, and explanation 


bsy DEV 0 1. 
where 


0 indicates SCSI bus 0 
1 indicates device 1 


Task: Busy device 1 of SCSI bus 0. 


Response: Command passed 


Explanation: Device busy request is complete with no failures. 
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bsy (continued) 


Examples of the bsy command (continued) 


Example Task, response, and explanation 


bsy DEV 0 all. 
where 


0 indicates bus 0 
Task: Busy all devices on SCSI bus o. 
Response: Command passed 


Explanation: Device busy request is complete with no failures. 


bsy SCSI 0 1. 
where 


0 indicates SCSI bus 0 
1 Indicates controller 1 


Task: Busy SCSI bus 0 of controller 1. 


Response: Command passed 


Explanation: Device busy request is complete with no failures. 


bsy ctrl 0. 
where 


0 indicates controller O 
Task: Busy both SCSI bus 0 and 1 of controller 0. 
Response: Command passed 


Explanation: Device busy request is complete with no failures. 
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bsy (continued) 


Responses 


The following table provides explanations of the responses to the bsy 
command. 


Responses for the bsy command 
MAP output Meaning and action 


Command failed. The PM is not responding. 


Meaning: Busy device has failed either because FP maintenance did not receive 
the request or it did not respond to it. 


Action: None 


Request has been submitted 
Meaning: The FP has just received the request. 


Action: None 
Command rejected. The device is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The device is already manually busy. 
or 
Command rejected. The device is under test 
or 


Command rejected. Device is not available. Check SCSI on enabled CTRL. 


Meaning: The busy device is rejected for the indicated reason. 


Action: None or as indicated. 
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bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


Command rejected. The SCSI is unequipped. 
or 

Command rejected. Maintenance already in progress. 
or 

Command rejected. The SCSI is already manually busy. 
or 

Command rejected. The SCSI is under test 


or 


Command rejected. Devices on SCSI bus must be manually busy first. 
Meaning: The device busy is rejected for the indicated reason. 


Action: None or as indicated. 
Command rejected. The CTRL is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The CTRL is already manually busy. 
or 
Command rejected. The CTRL is under test 
or 


Command rejected. Devices on SCSI bus must be manually busy first. 


Meaning: The device busy is rejected for the indicated reason. 


Action: None or as indicated. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-426 DEVICES (FP) level commands 
bsy (end) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


Command passed 


Meaning: Device busy request is complete with no failures. 


Action: None 
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next 


Function 


Using the next command at the (FP) DEVICES level produces a message 
directing the user to return to the main FP MAP level before entering the 
next command. This prevents problems which ocur when the next command 
1s nested too deeply within PM MAP levels. 


next command parameters and variables 


Command 


Parameters and variables 


There are no parameters or variables. 


Qualifications 


Example 


None 


The following table provides an example of the next command. 


Example of the next command 


Example 


Task, response, and explanation 


Task: Execute next 


Response: 
You cannot use NEXT from the FP Devices MAP level. 
To use NEXT return to the FP. or PM MAP level. 


Explanation: The next command cannot be executed from this level. 
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next (end) 


Response 
The following table provides an explanation of the response to the next 


command. 


Responses for the next command 


MAP output Meaning and action 


You cannot use NEXT from the FP Devices MAP level. 
To use NEXT return to the FP. or PM MAP level. 


Meaning: The next command cannot be executed from this level. 


Action: Return to the FP level before entering the next command. 
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offl 


Function 


Use the offl command to place specified devices or small computer systems 
interface (SCSI) busses offline and to display the results. 


offl command parameters and variables 


Command Parameters and variables 


scsi_num dev_num walt roly 
all nowait noreply 


ctrl, num scsi_num 
ctrl_ num 


Parameters 
and variables Description 


This parameter indicates the user wants to offline all devices on an FP node. 


This parameter indicates the user wants to bsy all SCSI busses associated with the 
controller (CTRL). 


This variable specifies a controller and has a range of 0-1. 


This parameter indicates the user wants to offline one or more devices on an FP 
node. 


This variable specifies a device and has a range of 0-5. 


This parameter inhibits all prompts and causes the command to execute as thoug 
all prompt responses were, “yes.” 


This parameter inhibits all responses from the execution of the command. 


This parameter enables additional commands to be entered at a MAP terminal 
without waiting for the command to be completed. 


This default parameter, which is never entered, indicates that the command will 
provide prompts because the noprompt parameter was not used. 


This default parameter, which is never entered, indicates that the command will 
produce MAP screen responses because the noresponse parameter was not used. 


This parameter indicates the user wants to offline a particular set of SCSI bus 
hardware, such as SCSI interface paddleboard (SIP), storage device interface 
paddleboards (SDIP), dual access buffer memory (DABM), on a controller. 
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offl (continued) 


offl command parameters and variables (continued) 


Parameters 
and variables Description 


This variable SCSI hardware and has a range of 0-1. 


This default parameter, which is never entered, indicates that the user must wait 
until the command has completed executing before additional commands can be 
entered, because the nowait parameter was not used. 


Qualifications 
None 


Examples 
The following table provides examples of the offl command. 


Examples of the offl command 


Example Task, response, and explanation 


offl DEV 0 1. 
where 


0 indicates SCSI bus 0 
1 indicates device 1 


Task: Offline device 1 of SCSI bus 0. 


Response: Command passed 


Explanation: Device offline request is complete with no failures. 


offl DEV 0 all 
where 


0 indicates bus 0 
Task: Offline all devices on SCSI bus 0. 
Response: Command passed 


Explanation: Device offline request is complete with no failures. 
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offl (continued) 


Examples of the offl command (continued) 


Example Task, response, and explanation 


offl SCSI 0 1 
where 


0 indicates SCSI bus 0 
1 Indicates controller 1 


Task: offline SCSI bus O of controller 1. 


Response: Command passed 


Explanation: Device offline request is complete with no failures. 


offl ctrl 0 J 
where 


0 indicates controller 0 
Task: offline both SCSI bus 0 and 1 of controller 0. 
Response: Command passed 


Explanation: Device offline request is complete with no failures. 
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offl (continued) 


Responses 


The following table provides explanations of the responses to the offl 
command. 


Responses for the offl command 
MAP output Meaning and action 


Command failed. The PM is not responding. 


Meaning: Offline device has failed either because FP maintenance did not receive 
the request or it did not respond to it. 


Action: None 


Request has been submitted 
Meaning: The FP has just received the request. 


Action: None 
Command rejected. The device is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The device is already manually offline. 
or 
Command rejected. The device is under test 
or 


Command rejected. Device is nit available. Check SCSI on enabled CTRL. 


Meaning: The device offline is rejected for the indicated reason. 


Action: None or as indicated. 
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offl (continued) 


Responses for the offl command (continued) 


MAP output Meaning and action 


Command rejected. The SCSI is unequipped. 
or 

Command rejected. Maintenance already in progress. 
or 

Command rejected. The SCSI is already manually offline. 
or 

Command rejected. The SCSI is under test 


or 


Command rejected. Devices on SCSI bus must be manually busy first. 
Meaning: The device offline is rejected for the indicated reason. 


Action: None or as indicated. 
Command rejected. The CTRL is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The CTRL is already manually offline. 
or 
Command rejected. The CTRL is under test 
or 


Command rejected. Devices on SCSI bus must be manually busy first. 


Meaning: The device offline is rejected for the indicated reason. 


Action: None or as indicated. 
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offl (end) 


Responses for the offl command (continued) 


MAP output Meaning and action 


Command passed 


Meaning: Device offline request is complete with no failures. 


Action: None 
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postdev 


Function 


Use the postdev command to post one device, all devices or all devices of a 
particular type on an enabled small computer systems interface (SCSI) bus. 


postdev command parameters and variables 


Command Parameters and variables 


postdev bus_num all 
dev_num 
type dev_type 


Parameters 
and variables Description 


This parameter specifies all devices on the SCSI bus are to be posted. 


This variable specifies the number of the SCSI bus to be posted and has a range 
of 0-1. 


This variable specifies particular device on the SCSI bus to be posted and has a 
range of 0-5. 


This variable specifies the type of device to be posted, and will be selected from ohe 
of the following: 


ct cartridge tape drive 
dk disk 
od optical disk drive 


mt magnetic tape drive 


Qualifications 
None 
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postdev (continued) 


Example 
The following table provides an example of the postdev command. 


Example of the postdev command 


Example Task, response, and explanation 


postdev 10. 
where 


1 is the SCSI bus number 
0 is the specific device on bus 1 to be posted. 


Task: Post device 0 on SCSI bus 1. 

Response: FPOODKO6 Type DISK SCSI bus 1 Device O 
Shelf 3 Status Offl Shadow set UNKNOWN 
Quad 3 Drive Idle User 


Explanation: Disk, FPOODKO06, device 0 on SCSI bus 1, has been posted. 


Responses 


The following table provides an explanation of the response to the postdev 
command. 


The following table provides explanations of the responses to the postdev 
command. 


Responses for the postdev command 
MAP output Meaning and action 


command failed. The PM is not responding. 


Meaning: The post device has failed either because FP maintenance did not 
receive the request, or it did not respond to it. 


Action: None 


No device is posted 


Meaning: The post device has failed because the requested device is unequipped. 


Action: None 
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postdev (end) 


Responses for the postdev command (continued) 


MAP output Meaning and action 


Request has been submitted 


Meaning: The FP has just received the request. 


Action: None 
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queryfp 


Function 
Use the queryfp command to query specified devices, or small computer 
system interface (SCSD bus hardware (SIP, SDIP, DABM) and display the 
results. 


queryfp command parameters and variables 
Command Parameters and variables 
queryfp all nousers noflt 


scsi num all users flt 
dev_num 


dev_type 
ctrl_ num scsi_num 
ctrl_ num 


Parameters 
and variables Description 


This parameter indicates the inclusiveness of a previous parameter’s range as 
follows: 


Following the dev parameter, all indicates all devices on an FP are to be 
queried. 


Following the scsi_num variable, all indicates all devices on an SCSI bus 


are to be queried. 


This parameter indicates that one or more devices on an FP node are to be queriad. 


to be queried. 

This variable specifies a controller and has a range of 0-1. 

This parameter indicates that a dual access buffer memory (DABM) is to be queridd. 
This variable specifies a device and has a range of 0-5. 


This variable specifies a device type which is one of the following: 
cartridge tape drive 
disk 
optical disk drive 
magnetic tape drive 
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queryfp (continued) 


queryfp command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter that a particular set of SCSI bus hardware (SIFSDIP or DABM) on 
a controller. 


This variable specifies SCSI hardware and has a range of 0-1. 


This parameter indicates all devices of particular type on and FP node are to be 
queried. 


This default parameter, which is never entered, indicates that faults will not be 
queried because the flt parameter was not entered. 


This default parameter, which is never entered, indicates that users will not be 
queried and displayed because the users parameter was not entered. 


This parameter indicates that faults on the specified hardware are to be queried ard 
displayed. 


This parameter indicates that users on the specified hardware are to be queried and 
displayed. 


Qualifications 
None 


297-1001-821 Standard 04.01 June 1999 


DEVICES (FP) levelcommands D-441 
queryfp (continued) 


Example 
The following table provides an example of the queryfp command. 


Example of the queryfp command 


Example Task, response, and explanation 


queryfp dev o 1 fit 
where 


0 is the SCSI hardware 
1 is the number of the device on the SCSI bus 


Task: Query faults for device 1 on SCSI bus 0. 


Response: 
Dev Name SCSI Dev Type Quad Shelf Slot Status 


FPOODKO6 0 1 dk 0 2 14 InSv 
No fault bit was set for this device 


Explanation: Device 1 on SCSI bus 0 is displayed indicating that there are no 
faults. 


Responses 


The following table provides explanations of the responses to the queryfp 
command. 


Responses for the queryfp command 
MAP output Meaning and action 


command failed. The PM is not responding. 


Meaning: Queryfp has failed either because FP maintenance did not receive the 
request, or it did not respond to it. 


Action: None 


Request has been submitted 


Meaning: The FP has just received the request 


Action: None 
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D-442 DEVICES (FP) level commands 
queryfp (continued) 


Responses for the queryfp command (continued) 

MAP output Meaning and action 

Command rejected. The device is unequipped. 

or 

Command rejected. Maintenance already in progress. 

or 

Command rejected. The device is under test. 

or 

Command rejected. Device is not available. Check SCSI on enabled CTRL. 
or 


Command rejected. The SCSI is unequipped. 


Command rejected. The SCSI is under test. 
or 


Command rejected. The CTRL is unequipped. 


Command rejected. The CTRL is under test. 
Meaning: Command queryfp is rejected due to the reason indicated. 


Action: None 


Command 


Meaning: Command queryfp request is complete with no failures. 


Action: None 
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queryfp (end) 
Responses for the queryfp command (continued) 
MAP output Meaning and action 
Command failed The PM is not responding. 


Meaning: Command queryfp has failed either because FP maintenance did not 
receive the request, or it did not respond to it. 


Action: None 


Request has been submitted. 


Meaning: The FP has just received the request. 


Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DEVICES (FP) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DEVICES (FP) level has changed to the previous menu level. 
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D-446 DEVICES (FP) level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DEVICES (FP) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DEVICES (FP) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the CI level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DEVICES (FP) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DEVICES (FP) level with the display of the next higher MAP 
level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 


Use the rts command to return specified devices or small computer systems 
interface (SCSI) buses to service and to display the results. 


rts command parameters and variables 


Command Parameters and variables 


scsi num dev_num wait roly 
all nowait noreply 


ctrl, num scsi_num 
ctrl_ num 


Parameters 
and variables Description 


This parameter indicates the user wants to return to service all devices on an FP 
node. 


This parameter indicates the user wants to bsy all SCSI busses associated with the 
controller (CTRL). 


This variable specifies a controller and has a range of 0-1. 


This parameter indicates the user wants to return to service one or more devices 
on an FP node. 


This variable specifies a device and has a range of 0-5. 
This parameter inhibits all responses from the execution of the command. 


This parameter enables additional commands to be entered at a MAP terminal 
without waiting for the command to be completed. 


This default parameter, which is never entered, indicates that the command will 
produce MAP screen responses because the noresponse parameter was not used. 


This parameter indicates the user wants to return to service a particular set of SC$I 
bus hardware, such as SIP, SDIP, DABM, on a controller. 


This variable SCSI hardware and has a range of 0-1. 


This default parameter, which is never entered, indicates that the user must wait 
until the command has completed executing before additional commands can be 
entered, because the nowait parameter was not used. 
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rts (continued) 


Qualifications 
None 


Examples 
The following table provides examples of the rts command. 


Examples of the rts command 


Example Task, response, and explanation 


rts DEV 0 1. 
where 


0 indicates SCSI bus 0 
1 indicates device 1 


Task: Return to service device 1 of SCSI bus 0. 
Response: Command passed 


Explanation: Device return to service request is complete with no failures. 


rts DEV O all. 
where 


0 indicates bus 0 
Task: Return to service all devices on SCSI bus o. 
Response: Command passed 


Explanation: Device return to service request is complete with no failures. 


rts SCSI 0 1 4 
where 


0 indicates SCSI bus 0 
1 Indicates controller 1 


Task: Return to service SCSI bus 0 of controller 1. 


Response: Command passed 


Explanation: Device return to service request is complete with no failures. 
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rts (continued) 


Examples of the rts command (continued) 


Example Task, response, and explanation 


rts ctrl 0. 
where 


0 indicates controller 0 
Task: Return to service both SCSI bus 0 and 1 of controller 0. 


Response: Command passed 


Explanation: Device return to service request is complete with no failures. 
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rts (continued) 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


Command failed. The PM is not responding. 


Meaning: Return to service device has failed either because FP maintenance did 
not receive the request or it did not respond to it. 


Action: None 
Request has been submitted 
Meaning: The FP has just received the request. 
Action: None 
Command rejected. The device is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The device is already in service. 
or 
Command rejected. The device is under test 
or 


Command rejected. Device is not available. Check SCSI on enabled CTRL. 
Meaning: The return to service is rejected for the indicated reason. 


Action: None or as indicated. 
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rts (continued) 


Responses for the rts command (continued) 

MAP output Meaning and action 

Command rejected. The SCSI is unequipped. 
or 

Command rejected. Maintenance already in progress. 
or 

Command rejected. The SCSI is already in service. 
or 

Command rejected. The SCSI is under test 


or 


Command rejected. Devices on SCSI bus must be manually busy first. 
Meaning: The return to service is rejected for the indicated reason. 


Action: None or as indicated. 
Command rejected. The CTRL is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The CTRL is already in service. 
or 
Command rejected. The CTRL is under test 
or 


Command rejected. Devices on SCSI bus must be manually busy first. 


Meaning: The return to service busy is rejected for the indicated reason. 


Action: None or as indicated. 
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rts (end) 


Responses for the rts command (continued) 


MAP output Meaning and action 


Command passed 


Meaning: The return to service request is complete with no failures. 


Action: None 
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swen 


Function 
Use the swen command to switch the enabled SCSI bus. 


swen command parameters and variables 


Command Parameters and variables 
scsi_no no force prompt wait reply 
force noprompt|| nowait noreply 
Parameters 


and variables Description 


This parameter forces the system to switch the enabled SCSI bus. 


This parameter suppresses the display of allprompts. The default response to all 
prompts is yes, which corresponds to the wait and reply default conditions. 


This default parameter indicates that the system will not be forced to switch the 
active SCSI bus if the force parameter is omitted. 


This parameter suppresses all MAP responses resulting from the execution of the 
command. 


This parameter returns the MAP prompt immediately after the command is entered 
so that other commands may be entered. 


This default parameter indicates that the system will prompt the user if the nopro 
parameter is not entered. 


This default parameter indicates map responses will result from execution of the 
command when noreply parameter is not entered. 


This variable indicates the SCSI bus to be switched and has a range of 0-1. 


This default parameter indicates that, when the nowait parameter is not entered, 
the system waits until the command has completed before a MAP prompt appears 
allowing other commands to be entered. 


Qualifications 
None 
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swen (end) 


Example 
The following table provides an example of the swen command. 


Example of the swen command 


Example Task, response, and explanation 


is the number of the SCSI bus 


Task: Switch the enable SCSI bus to SCSI 0 
Response: FP 0 SwEn SCSI SCSI 0: Command passed. 


Explanation: The system switched the enabled SCSI bus to SCSI 0. 


Responses 
The following table provides explanations of the responses to the swen 


command. 


Responses for the swen command 
MAP output Meaning and action 
Command failed. The PM is not responding. 


Meaning: The BSY command failed because the FP maintenance system did not 
receive the request, or because it did not respond to it. 


Action: Contact the personnel responsible for the next level of support. 


Command rejected. Maintenance already in progress. 


Meaning: The BSY command has been rejected because a maintenance process 
is already in progress on the specified device. 


Action: Wait for the maintenance process to finish, then enter the BSY 
command. 
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tst 


Function 
Use the tst command to test and to display the results for a small computer 
systems interface (SBSI), bus hardware {SCSI interface paddleboard (SIP), 
storage device interface paddleboards (SDIP), or dual access buffer memory 
(DABM), on a controller}, or all SCSI related hardware on an FP. 


tst command parameters and variables 


Command Parameters and variables 


scsi_num dev_num walt reply 
ctrl_num scsi num | nowait noreply 
ctrl_ num 


Parameters 
and variables Description 


This parameter indicates the user wants to test all devices on an FP node. 


This parameter indicates the user wants to test all SCSI busses associated with the 
controller (CTRL). 


This variable specifies a controller and has a range of 0-1. 

This parameter indicates the user wants to test a DABM. 

This parameter indicates the user wants to test one or more devices on an FP node. 
This variable specifies a device and has a range of 0-5. 

This parameter inhibits all responses from the execution of the command. 


This parameter enables additional commands to be entered at a MAP terminal 
without waiting for the command to be completed. 


This default parameter, which is never entered, indicates that the command will 
produce MAP screen responses because the noreply parameter was not used. 


This parameter indicates the user wants to test a particular set of SCSI bus 
hardware, such as SIP, SDIP, DABM, on a controller. 
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tst (continued) 


tst command parameters and variables (continued) 


Parameters 
and variables Description 


This variable SCSI hardware and has a range of 0-1. 


This default parameter, which is never entered, indicates that the user must wait 
until the command has completed executing before additional commands can be 
entered, because the nowait parameter was not used. 


Qualifications 
None 


Examples 
The following table provides examples of the tst command. 


Examples of the tst command 


Example Task, response, and explanation 


tst DEV O 1. 
where 


(0) is the device number 
1 is the SCSI bus number 


Task: Test device 0 on SCSI bus 1. 
Response: Command passed 


Explanation: Testing of device 0 on SCSI bus 1 has completed with no errors. 


tst SCSI 0 1. 
where 


0 is the SCSI number 
1 is the controller number 


Task: Test SCSI 0 of controller 1. 


Response: Command passed. 


Explanation: The test of SCSI 0 of controller 1 has completed with no errors. 
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tst (continued) 


Examples of the tst command (continued) 


Example Task, response, and explanation 


tst ctrl 1. 
where 


4 
Task: Test SCSI busses 0 and 1 on controller 1. 
Response: Command passed. 


Explanation: The test of SCSI busses 0 and 1 of controller 1 has completed with 
no errors. 


tst dabm 0. 
where 


0 is the controller number. 
Task: Test DABM on controller 0. 


Response: Command passed. 


Explanation: The test of DABM of controller 0 has completed with no errors. 


tst 


Task: Test all hardware on the FP. 
Response: Command passed. 


Explanation: All hardware on the FP is tested without error. 


Responses 


The following table provides explanations of the responses to the tst 
command. 
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tst (continued) 


Responses for the tst command 
MAP output Meaning and action 


Command failed. The PM is not responding. 


Meaning: Test device has failed either because FP maintenance did not receive 
the request or it did not respond to it. 


Action: None 
Request has been submitted 
Meaning: The FP has just received the request. 
Action: None 
Command rejected. The device is unequipped. 
or 
Command rejected. Maintenance already in progress. 
or 
Command rejected. The device is already in service. 
or 
Command rejected. The device is under test 
or 


Command rejected. Device is not available. Check SCSI on enabled CTRL. 


Meaning: The test is rejected for the indicated reason. 


Action: None or as indicated. 
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Responses for the tst command (continued) 


MAP output 


Command 


or 


Command 


or 


Command 


or 


Command 


or 


Command 


Command 


or 


Command 


or 


Command 


or 


Command 


or 


Command 


rejected. 


rejected. 


rejected. 


rejected. 


Meaning and action 


The SCSI is unequipped. 


Maintenance already in progress. 


The SCSI is already in service. 


The SCSI is under test 


rejected. 


tst (continued) 


Devices on SCSI bus must be manually busy first. 


Meaning: The test is rejected for the indicated reason. 


Action: 


rejected. 


rejected. 


rejected. 


rejected. 


rejected. 


None or as indicated. 


The CTRL is unequipped. 


Maintenance already in progress. 


The CTRL is already in service. 


The CTRL is under test 


Devices on SCSI bus must be manually busy first. 


Meaning: The test busy is rejected for the indicated reason. 


Action: 


None or as indicated. 
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tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


Command passed 


Meaning: The test request is complete with no failures. 


Action: None 
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disp (end) 


Function 
Use the disp command is not implemented for the DEVICES (LMX) level. 
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D-465 


DEVICES (LMX) level commands 


Use the DEVICES (LMX) level of the MAP to obtain information about and 
perform maintenance functions on a channel frame interface (LMX). 


Accessing the DEVICES (LMX) level 
To access the DEVICES (LMX) level, enter the following from the CI level: 
mapci;mtc;pm;post Imx Imx_no;devices .| 


where 


Imx_no is the number of the LMX to be posted. 


DEVICES (LMX) commands 


The commands available at the DEVICES (LMX) MAP level are described 
in this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DEVICES (LMX) commands 


Command 
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DEVICES (LMX) commands (continued) 


Command 


DEVICES (LMX) menu 


The following figure shows the DEVICES (LMX) menu and status display. 
The insert with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
21STb 
Device SysB ManB Offl Cbsy ISTb InSv 

Quit PM 0 0 0 0 2 8 

Post_ LMX 0 0 0 = I I: 
LMX 0: DS3 Trunks IsTb (NA) /Mtce 

Trnsl_ 

Tst_ Act Status 

Bsy_ Unit 0 A InSv (NA) RexFlt 

RTS_ Unit 1 I ManB /Mtc /Loadint: 200 

l Msg-Chan PM-Msg-Chan Payload 

Disp_ LMX 0 1 11111 11111 22222 Msf-Chan 
Unit 0 . E 01234 56789 01234 56789 01234 o 1 

SwAct_ Unit 1 i . a N ee u dE 

QueryDV_ 


IdMtce_ 


Hidden commands 


abtk 


Common responses 


The following table provides explanations of the common responses to the 
DEVICES (LMX) commands. These responses will be produced by many 
of the commands under the DEVICES (LMX) level. This table will be 

referred to from the individual command descriptions to which it pertains. 
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Responses for the DEVICES (LMX) commands 


MAP output Meaning and action 


Command initiated. Expected completion within <n> 
Meaning: Maintenance has started executing. The action should be completed in 
time <n> where: 


<n> is s specified amount of time. 
Action: None 


Command aborted. No HOST links exist to node. 
Meaning: Although the node itself has been datafilled, no links connecting it to its 
C-side node have been data filled (or made known to node or link 


maintenance). 


Action: Provide link data information and reenter the command. 


Command aborted. No communication path open to the node 


Meaning: The node is not accessible because of error in links connecting it to the 
maintenance host. 


Action: Determine whether problems exist with the link hardware. If so, correct 
the problem and reenter the command. 


Command aborted. Node is not responding. 


Meaning: Although the node is accessible, it is not responding to the command 
request. It is possible that the LMX has not yet been loaded or that it is 
experiencing problems in its software or hardware that are preventing it 
from communicating properly. 


Action: Determine whether problems exist with the load or in any of the node 
hardware. If so, correct the problem and reenter the command. If not, 
or if a software problem is suspected contact next level of maintenance 
support. 


Command aborted. Maintenance in progress on node. 


Meaning: Other maintenance actions are being executed on the node as indicated 
by the “/Mtce” flag on the units MAP display. 


Action: reenter command when the “/Mtce” flag on the units MAP display is 
removed. 
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Responses for the DEVICES (LMX) commands (continued) 
MAP output Meaning and action 


All parameter may only be used in WAIT mode. 
Meaning: The ALL parameter was specified in one of two illegal situations: 


the CI session is in nonwait mode 
the user specified a nowait parameter with the command 
Action: reenter the command using the using the wait parameter 


WAIT mode not available. Execute command in no-WAIT mode? 


Meaning: The session is in wait mode, but a lack of system resources prevents the 
required messaging interactions from occurring. The user is therefore 


prompted to determine ifthe command can be executed in the nowait 
mode. 


Action: If willing to execute the command in the nowait mode respond by 
entering, “yes,” otherwise enter, “no.” 


Messaging currently unavailable with “ALL” parameter. 


Meaning: Alack of system resources prevents the required messaging interactions 
from occurring. The command is aborted. 


Action: The session should be placed into nowait mode, then the command 
should be reentered for all nodes in the post set. 


Command aborted. External abort received by maintenance. 


Meaning: command request has be terminated by the MAP abtk command. 
Action: None 


Command aborted. Software inconsistency. 


Meaning: Software received an unexpected return code or condition at some time 


during the command execution. A SWERR log is produced and the 
command is terminated. 


Action: This problem can only be fixed with t software update. Collec SERRS 
and other logs produced and submit them to technical support. 
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abtk 


Function 


Use the abtk command to abort maintenance action currently running on the 
posted LMX. 


abtk command parameters and variables 


Command Parameters and variables 


Imx unit_num prompt wait reply 
msgch unit_num ms_num noprompt || nowait noreply 
payloadch ms_num 

pmch chan_num 


Parameters 
and variables Description 


This variable indicates which PM channel is to have its task aborted, and has a 
range of 0-1. 


This parameter causes the task for the LMX to be aborted. 
This parameter causes the task for the message channels to be aborted. 


This parameter indicates that a PM message channel to an HSI is to have its task 
aborted. 


This variable is number of the message channel and has a range of 0-1. 


This parameter indicates that a payload message channel to an MS is to have its 
task aborted . 


This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the abtk command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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abtk (continued) 


abtk command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered atthe MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
None 


Example 
The following table provides an example of the abtk command. 


Example of the abtk command 


Example Task, response, and explanation 


abtk Imx 1. 
where 


1 is the number of the LMX unit 
Task: Abort any maintenance task currently running of LMX unit 1. 


Response: AbTk 


Explanation: The current task running of LMX unit 1 is aborted. 
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abtk (end) 
Responses 


The following table provides explanations of the responses to the abtk 
command. 


Responses for the abtk command 
MAP output Meaning and action 
Command identifier for AbTk command is “AbTk”. 


Meaning: The task currently executing on the specified component has been 
aborted. 


Action: None 
Command failed. Current task could not be aborted. 


Meaning: The task currently executing on the specified component could not be 
aborted. 


Action: None 


Command aborted. No task to abort. 


Meaning: No maintenance task is currently executing on the specified component. 


Action: None 
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bsy 
Function 


Use the bsy command to place the card or link on the posted DFI in the 
manual busy (ManB) state. 


bsy command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
payloadch fpb_num noprompt || nowait noreply 
pmch chan_num 


bsy noforce 
(continued) force 


Parameters 
and variables Description 


This variable indicates which PM channel is to be selected, and has a range of 0-1. 


This parameter will force an ISTb component to be busied immediately without 
waiting for current tasks to be completed. 


This parameter causes the message channels to be busied. 


This variable is number of the message channel and has a range of 0-1. 


This default parameter, which is never entered, indicates that component will not 
be forced to the busy state immediately because the force parameter is not enterep. 


This parameter prevents all prompting. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter indicates that a payload message channel to an MS is to selected 


This parameter indicates that a PM message channel to an HSI is to be selected. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 
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bsy (continued) 


bsy command parameters and variables (continued) 


Parameters 
and variables Description 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


The force parameter forces all work currently in progress on the unit to 
terminate immediately. Normally, work in progress continues to completion 
before the unit is made busy. The force parameter should only be sued when 
a rapid shutdown of the unit hardware is required. 


Example 
The following table provides an example of the bsy command. 


Example of the bsy command 
Example Task, response, and explanation 


bsy netlink 1 — 
where 


1 is the number of the the DS-512 paddle board to be busied. 


Task: Busy DS-512 paddle board number 1 in the posted LMX. 


Response: Command successful. Component has been manually 
busied. 


Explanation: The bsy command is successful. 
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bsy (end) 


Responses 


The following table provides explanations of the responses to the bsy 
command. 


Responses for the bsy command 


MAP output Meaning and action 


WARNING: 

The FORCE option should only be used when a fast shutdown of the hardware 
is desired. All work in progress will be terminated. Please confirm 
(“YES” or “NO”). 


Meaning: The FORCE option must be verified. 


Action: Enter “YES” to continue the bsy command or“NO” to stop it. 


Command aborted. Busying link will isolate node. 


Meaning: If the specified message link is busied, the posted LMX will be isolated 
becasue the other message link is not available. 


Action: None 


Command successful. Component has been manually busied. 
Meaning: Bsy command is successful 


Action: None 


Command failed. Unit must be in-service or system-busy. 


Meaning: Unit cannot be manually busied unless it is either InSv or SysB. 


Action: None 
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idmtce 


Function 


Use the idmtce command to turn the LED on the specified card of the posted 
LMX on or off. 


idmtce command parameters and variables 


Command Parameters and variables 


idmtce unit_num on prompt wait reply 
off noprompt| | nowait noreply 


Parameters 
and variables Description 


This parameter selects the LMX. 
This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter causes the LED to be turned off. 
This parameter causes the LED to be turned on. 


This default parameter, which is never entered, indicates that prompts will be issug 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered atthe MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


Because LEDs can be used to identify cards which should be pulled, the user 
will be prompted for verification before the command will be continued. 


Example 
The following table provides an example of the idmtce command. 
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D-478 DEVICES (LMX) level commands 
idmtce (continued) 


Example of the idmtce command 


Example Task, response, and explanation 


idmtce Imx 0 on .| 
where 


0 is the LMX unit number. 
Task: Turn the LED of LMX unit 0 on. 
Response: Command successful. LED turned ON. 


Explanation: The LED of LMX unit 0 is on. 


Responses 


The following table provides explanations of the responses to the idmtce 
command. 


Responses for the idmtce command 
MAP output Meaning and action 
Command aborted. LED is already ON. (or OFF) 


Meaning: The command is not executed because the LED is already in the 
requested state. 


Action: None 


Command successful. LED turned ON. (or OFF) 


Meaning: The LED of selected LMX unit is in the selected state. 


Action: None 
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idmtce (end) 


Responses for the idmtce command (continued) 
MAP output Meaning and action 
WARNING: 


The specified card is active. 
Please confirm (“yes” or “NO”). 


Meaning: The card is active and since LEDs are sometimes used to identify cards 


that require replacement, the user must confirm that the command ought 
to continue. 


Action: Response with “yes” to turn the LED on, or “no” to abort the command. 
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post 


Function 
Use the post command to select a specific LMX upon which action is to be 
performed by other commands. The post command must be used before 
entering commands swrg, trnsl, tst, bsy, rts, offl, loadpm, or querypm. 


post command parameters and variables 


Command Parameters and variables 


all pms 
site 
frame 
pm_state 


pm_type all 
pm_number...pm_number 


Parameters 
and variables Description 


allpms This parameter posts all PM types. 


site This variable posts all PM types at the site, where site is a four-character 
alphanumeric string. 


frame This parameter posts all PM types within the specified frame. The range is 0 to 99. 
pm-state This variable specifies a state and all pms in that state will be posted. 


pm_type This variable identifies the type of PM to be posted, which is the LMX. If the 
LMX PM level is already accessed, the pm_type may be omitted. 


all This parameter specifies that all LMX be posted. 


pm_number This variable specifies which LMX is to be posted. The range is 0 to 127. More than 
one LMX is posted by entering their discrimination numbers separated by a blank 
space. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 


limitations. 
+ An LMX cannot be posted if it is not listed in Table LTCINV and 
LTCPSINV. 


e LMXs appear as a group on the display. From this group, specific LMXs 
may be posted by number. 
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D-482 DEVICES (LMX) level commands 
post (continued) 


e The post command displays vary depending on the PM type and the PM 
set. 

e If parameters Imx or allpms is entered alone with the post command, the 
menu commands on the new display level are used to select specific PM 
numbers. 

e A list of current PM types and their discrimination number ranges can be 
displayed by entering the command disp. 

e When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs that are present in the office configuration. For parameters that do 
not apply, one of several responses indicates that it is ignored. 


Example 
The following table provides an example of the post command. 


Example of the post command 


Example Task, response, and explanation 


post Imx all. 
Task: Post all LMXs 
Response: <Display for first LMX> 


Explanation:All LMXs are posted. 
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post (end) 


Responses 


The following table describes the meaning and significance of responses to 
the post command. 


Responses for the post command 


MAP output Meaning and action 


NO PM POSTED 


Meaning: The LMX level is accessed without posting a specific LMX. 


Action: None 


pm_type x INSV LINKS_OOS: CSIDE y PSIDE z 
UNIT 0: activity state 
UNIT 1: activity state MCTE 


Meaning: The status of the posted LMX is displayed below the PM status display, 
where: 


pm_type is LMX for the type of PM. 
x is the discrimination number of the PM type. 
y is the quantity of C-side linjks that are out-of-service. 
Z is the number of P-side that are out-of-service. 
activity is the activity of each unit, where: 
ACT _ is for an active unit, that is, actually 
processing calls 
INACT is for an inactive unit, that is, on standby for 
the active unit 
state is one of the PM states listed and described In Table C 
on page 67. 
MTCE appears when a unit is undergoing maintenance actions 
(invoked manually or by the system). 


Action: None 
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querydv 


Function 


Use the querydv command to display specified information about the 
components of the LMX. 


querydv command parameters and variables 


Command Parameters and variables 


querydv unit_num | wait reply 
nowait noreply 


msgch unit_num ms_num 
payloadch ms_num 

pmch chan_num 

location 


Parameters 
and variables Description 


This parameter causes the LMX to be queried. 


This default parameter, which is never entered, indicates that the standard 
information will be displayed because neither the flt or idprom parameters are 
entered. 


This parameter causes fault information to be displayed. 
This parameter causes IDPROM information to be displayed. 
This parameter causes the location of the queried component to be displayed. 


This parameter causes the message channels to be queried. 


This parameter causes a PM message channel to an HSI to be queried. 


This variable is number of the message channel and has a range of 0-1. 
This parameter causes a payload message channel to an MS to be queried. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 
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D-486 DEVICES (LMX) level commands 
querydv (continued) 


querydv command parameters and variables (continued) 


Parameters 
and variables Description 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


The querydv command is qualified by the following exceptions, restrictions, 
and limitations: 


e The default information is state informtion applying to the specified 
component. Although component states are constatnly update, this 
command is still necessary to make state informtion available to users of 
paper terminals and MAP with the nodisp option. 


e Options can be used to see fault information for all components, and 
IDPROM information for cards. 


e If there are multiple faults for a card, the first fault description will be 
displayed, followed by its card list, then the next fault followed by its 
card list and so on. Faults are listed with the most critical faults 
appearint first. 
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querydv (continued) 


Examples 
The following table provides examples of the querydv command. 


Examples of the querydv command 


Example Task, response, and explanation 


querydv msgch 0 1. 
where 


0 is the unit number 
1 is the number of the message channel 


Task: Query the state of message channel unit O channel 1. 

Response: STATUS: INSV 

Explanation: Message channel unit O channel 1 is inservice. 
querydv Imx idprom J 

Task: Query idprom for LMX currently posted. 

Response: IDPROM read: idl IDPROM expected: id2 


Explanation: Discrepancy in expected and detected proms displayed. 


Responses 


The following table provides explanations of the responses to the querydv 
command. 


Responses for the querydv command 


MAP output Meaning and action 


Command aborted. Component is unequipped. 


Meaning: There is nothing to report as the specified component is not equipped. 


Action: None 
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querydv (continued) 


Responses for the querydv command (continued) 


MAP output Meaning and action 


STATUS: <status> 


Meaning: The status of a card, link or message channel has been queried, and 
reported where: 


<status> is OFFL, MANB, SYSB, INSV, or ISTB. 
Action: None 


fault severity: card fault description 
<card_list> 


(for example) 


Critical Fault: endpoint: 2B eror code detected. 
LMX:0 Floor:2 Row:BB Frame:6 Shelf:3 Slot:14F PEC:NTMX38AA Li 


Meaning: The flt parameter has been specified. The information provided is as 
follows: 
fault severity no problem, noncritical or critical 
fault type endpoint or end to end 
link fault description a string describing the fault. 


card list a list of possible faulty cards and their 
locations 
Action: None 


IDPROM read: idl IDPROM expected: id2 


Meaning: The idprom parameter was entered and the following information is 
provided: 


ACP: The type of ACP (LMX, PSP, HFT or others) 


Description ACP type, ACP number, slot, physical slot number, 
and system action. 


Action: None 
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querydv (end) 


Responses for the querydv command (continued) 
MAP output Meaning and action 
Description Floor Row Frame Shelf Slot PEC 


LMX Unit 0 77 AB 12 2 TE NTMX38AA 
LMX Unit 1 77 AB 12 2 8F NTMX38AA 


Meaning: The location of all devices for the posted LMX has been queried. 
Information is provided as follows: 


description: the type of device and RP number if applicable 


location: This consists of the fields, floor, row, frame, shelf, slot, 
and PEC code. 
Action: None 
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quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DEVICES (LMX) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DEVICES (LMX) level has changed to the previous menu 
level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc .l 
where 


mtc specifies the level higher than the DEVICES (LMX) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DEVICES (LMX) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the CI level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DEVICES (LMX) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DEVICES (LMX) level with the display of the next higher 
MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 
Use the rts command to return to service a card or link on the posted CFI. 


rts command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
payloadch ms_num noprompt || nowait noreply 
pmch chan_num 


Parameters 
and variables Description 


This variable indicates which PM channel is to be selected, and has a range of 0-1. 


This parameter will force an ISTb component to be returned to service without 
testing. 


This parameter causes the message channels to be returned to service. 


This variable is number of the message channel and has a range of 0-1. 


This default parameter, which is never entered, indicates that testing will be 
performed on component before being returned to service because the force 
parameter is not entered. 


This parameter prevents all prompting. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter indicates that a payload message channel to an MS is to selected 


This parameter indicates that a PM message channel to an HSI is to be selected. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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rts (continued) 


rts command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The component must be ManB or SysB before it can be returned to service. 


Example 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


rts msgch 0 1.1 
where 


0 is the unit number 
1 is the message channel number 


Task: Return message channel unit 0 channel 1 to service. 


Response: Command successful. Component has been returned 
to service. 


Explanation: The rts command successfully returned the circuit to service. 
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rts (end) 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


WARNING: 
The FORCE option should only be used to RTS a component in the ISTb state 
(to avid testing). Please confirm (“YES” or “NO”). 


Meaning: The force parameter was entered with the RTS command. The system 
waits for response. 


Action: Enter yes to continue the command or no to terminate it. 
Command aborted. Component already inservice. 
Meaning: It is not possible to return to service a component already inservice. 
Action: None 
Command successful. Component has been returned to service. 
Meaning: Component has passed testing and been returned to service. 


Action: None 


Command successful. Component has been returned to in-service trouble. 


Meaning: The component failed testing but faults are not serious enough to affect 
service. 


Action: None 


Command failed. Failures occurred during component testing. 


Meaning: When an rts command is issued, diagnostics are performed on the 
component before returning it to service. Diagnostic failures have 
occurred and are reported. The errors are sever enough that the 
component cannot be returned to service. 


Take corrective maintenance action called for by indicated failure. 
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swact 


Function 
Use the swact command is not implemented at the DEVICES (LMX) level. 
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trnsl 


Function 


Use the trnsl command to identify the components in the path of the physical 
link connections to the ENET and MS and the message channel connections 
to the MS for the posted CFI node. 


trnsl command parameters and variables 
Command Parameters and variables 
msgch unit_num ms_num 
payloadch ms_num 


pmch chan_num 


Parameters 
and variables Description 


chan_num This variable indicates which PM channel is to be selected, and has a range of 0-{. 
msgch This parameter causes the message channels to be selected. 
ms_num This variable is number of the message channel and has a range of 0-1. 


payloadch This parameter indicates that a payload message channel to an MS is to selected 


pmch This parameter indicates that aPM message channel to an HSI is to be selected. 


unit_num This variable is the number of the unit and has a range of 0-1. 


Qualifications 
None 
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trnsl (continued) 


Example 
The following table provides an example of the trnsl command. 


Examples of the trnsl command 


Example Task, response, and explanation 


trnsl msgch 0 1.1 
where 


0 is the CFI unit number 
1 is the message switch number 


Task: Display location information for the control message channel from 
CFI 0 to message switch 1. 


Response: FPB Description of MS links 
1 FPBO / MS 1, Shelf 0, Chain 18, Link 1 


Explanation: Information for the control message channel from CFI 0 to 
message switch 1 is displayed. 


Responses 


The following table provides explanations of the responses to the trnsl 
command. 


Responses for the trnsl command 
MAP output Meaning and action 
Unit MsgCh Description of Message Channels 


0 0 LMX 12, Unit 0/ MS 0, Shelf 0, Chain 18, Link 1, Port 3 
via FPB 0, Link 1 


Meaning: Response to Trnsl msgch 0 0 command. 


Action: None 
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trnsl (end) 


Responses for the trnsl command (continued) 


MAP output Meaning and action 


Description of Message Channels LMX 12, PM-Msg-Chan 13 
/CFI 10 

/ENET Shelf 2, Slot 14, Link 3 (-CFI) 

/ENET Shelf 1, Slot 12, Link 2 (-HSI) 

/HSI 3, Unit 1 


Meaning: Response to the trnsl pmch command. 


Action: None 


PayloadCh Description of Message Channels 
0 LMX 12, PayloadCh 0/ MS 0, Shelf 0, Chain 18, Link 1 Port 3 
via CFI 3, FPB 0, Link 1 
1 LMX 12, PayloadCh 1/ MS 0, Shelf 0, Chain 18, Link 1 Port 3 
via CFI 3, FPB 1, Link 1 


Meaning: Response to the trnsl payloadch command. 


Action: None 
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DEVICES (LMX) level commands D-505 
tst 


Use the tst command to test specified cards or links and display the results. 


tst command parameters and variables 


Command 


Imx 
msgch 
payloadch 
pmch 


Parameters and variables 


wait 
nowait 


unit_num 
unit_num 
ms_num 
chan_num 


prompt 
noprompt 


reply 
noreply 


ms_num 


Parameters 


and variables Description 


This parameter causes the LMX to be tested. 

This variable indicates which PM channel is to be selected, and has a range of 0-1. 
This parameter causes the message channels to be tested. 

This variable is number of the message channel and has a range of 0-1. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter indicates that a payload message channel to an MS is to selected 


This parameter indicates that a PM message channel to an HSI is to be selected. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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tst (continued) 


tst command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The kind of tests that will be run is determined by wether the component is 
inservice or out-of-service. 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


tst msgch 0 1.1 
where 


0 is the LMX unit number 
1 is the message switch number 


Task: Test message switch number one on LMX unit 0. 


Response: Command passed. Component passed all tests. 


Explanation: The test of message switch number one on LMX unit O passed. 
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tst (end) 


Responses 


The following table provides explanations of the responses to the tst 
command. 


Responses for the tst command 


MAP output Meaning and action 


Specified card is unequipped. Card in slot will be tested anyway. 
Pleas confirm (“YES“ or “NO”). 


Meaning: The card to be tested is not equipped. The system waits for verification. 


Action: To test the unequipped card enter yes else enter no. 


Command aborted. Component already under test. 
Meaning: It is impossible to test a component already being tested. 
Action: None 
Command aborted. Component is offline. 
Meaning: A component must be on line to be tested. 
Action: None 
Command passed. Component passed all tests. 
Meaning: Test specified passed. 


Action: None 


Command failed. Component failed test. 


Meaning: The specified component failed a test issued against it. The reason for 
the failure is displayed. 


Action: None 
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D-509 


DEVICE (NIU) level commands 


Use the DEVICE (NIU) level of the MAP to to display information about 
link interface unit (LIU) components connected to the network interface unit 
(NIU). 


Accessing the DEVICE (NIU) level 
To access the DEVICE (NIU) level, enter the following from the CI level: 
mapci;mtc;pm;post niu niu_no;devices .| 


where 


niu_no specifies the niu number and has a range 0-99. 


DEVICE (NIU) commands 


The commands available at the DEVICE (NIU) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DEVICE (NIU) commands 


Command 
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D-510 DEVICE (NIU) level commands 


DEVICE (NIU) menu 


The following figure shows the DEVICE (NIU) menu and status display. 
The insert with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
DEVICE SysB ManB Offl Cbsy IStb InSv 
0 Quit PM 0 0 0 0 4 14 

2 NIU 0 0 0 0 0 0 
3 

4 NIU 2: ISTb 

5 Trnsl Unit o: InAct ISTb 
6 Unit 1: Act InSv 
7, 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 
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quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DEVICE (NIU) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DEVICE (NIU) level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DEVICE (NIU) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DEVICE (NIU) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DEVICE (NIU) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DEVICE (NIU) level with the display of the next higher MAP 
level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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trnsl 


Function 


Use the trnsl command to display the network nodes that are connected to 
each C-side link, or the peripherals that are connected to each P-side port. A 
network node referes to a plane and shelf designation within the network 
subsystem. 


trnsl command parameters and variables 


Command Parameters and variables 
port_number 


Parameters 
and variables Description 
netlk This parameter displays the network nodes associated with each link. 


port This parameter displays the peripheral that is associated with the spcified port. 


port_number This variable specifies the port number and has a range of 0-10. 


orts This parameter displays the peripherals that is associated with each port. 


Qualifications 
None 
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trnsl (continued) 


Examples 


The following table provides examples of the trnsl command. 


Examples of the trnsl command 


Example 
trnsl netik — 


Task: 


Response: 


Explanation: 


trnsl ports . 


Task: 


Response: 
Port 
Port 

t 


15, 
51; 
95, 


Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 1 


Explanation: 


1 
2 
o 


3 


4 
5 
6 
7 
8 
9 
0 


Task, response, and explanation 


Display the network link status. 


Link 
Link 
Link 
Link 
Link 
Link 
Link 
Link 


NET 


NINSUPwWMN Ho 


0 
0 


0 


0 


wwHmHwwhhr 


58;Cap 
58;Cap 
62;Cap 
62;Cap 
17;Cap 
17;Cap 
56;Cap 
56;Cap 


Stat 
Stat 
Stat 
Stat 
Stat 
Stat 
Stat 
Stat 


US 
US 
US 
US 
US 
US 
US 
US 


; TIMING 
; TIMING 

OK 

OK 

OK 

OK 

OK 

OK 


In the above example, plane 0, shelf 1 of the network is connected 
to link 0. Likewise, plane 1, shelf 3 of the network is connected to 
line 3. 


Display the status of all ports connected to the NIU. 


is unowned. 
is owned by XLIU 131 and has 30 channels allocate 
The allocated channels are: 


Ita 
17,19, 21; 
537-63; 69,5 
97; 99; 101, 111, 113, 115, 117, 127, 129 


is 
is 
is 
is 
is 
is 
is 
is 


unowned. 
unowned. 
unowned. 
unowned. 
unowned. 
unowned. 
unowned. 
unowned. 


31, 
67, 


33, 
69, 


33, 31; 
19, 81, 


47, 49 
83, 85 


In the above example, only port 2 has a peripheral, an XLIU, 


connected to it. 
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trnsl (end) 


Examples of the trnsl command (continued) 


Example Task, response, and explanation 


trnsl port 2.1 
where 


2 is the number of the port. 


Task: Display the status of port 2. 


Response: 
Port 2 is owned by XLIU 131 and has 30 channels 
allocated to it. The allocated channels are: 
15, 17, 19. :2Ly -31,. -337 -39/ -37y “47,5. 49 
Si 535! 637 65, 67, 69, 79, 81, 83, 85 
O55. (94). < 995, LOL, LEL BLS 2132.17, 12T, 129 


Explanation: In the above example, the peripheral that is associated with port 2 
is displayed. 


Respons 


The following table provides an explanation of the response to the trnsl 
command. 


Response for the trnsl command 


MAP output Meaning and action 


Port 2 is owned by XLIU 131 and has 30 channels allocated to it. The 
allocated channels are: 

15, 175: 19%: .28,- 81; Bn S857. 33%. 4775; 49 

51,-535,.63, 657 OF» 69%, 1419, BL 83%- 185 

95, -97y 995-101, 111; -113,- bis, 117, 127, 129 


Meaning: Tyupicla response to a trnsl command such as trhe following 


trnsl port 2.1 


Action: None 
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D-519 


DEVICES(PSP) level commands 


Use the DEVICES(PSP) level of the MAP to obtain information about and 
perform maintenance functions on a programmable signal processor (PSP). 


Accessing the DEVICES(PSP) level 
To access the DEVICES(PSP) level, enter the following from the CI level: 
mapci;mtc;pm;post PSP psp_no;devices .| 


where 


psp_no is the number of the PSP to be posted. 


DEVICES(PSP) commands 


The commands available at the DEVICES(PSP) MAP level are described in 
this chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DEVICES(PSP) commands 


Command 


abtk 
bsy 
disp 
idmtce 
post 
querydv 


quit 
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DEVICES(PSP) commands (continued) 


Command 


DEVICES(PSP) menu 


The following figure shows the DEVICES(PSP) menu and status display. 
The insert with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext 
21STb 
Device SysB ManB Offl Cbsy ISTb InSv 
Quit PM 0 0 0 0 2 8 
Post_ PSP 0 0 0 2 1 1 


PSP 0: Messaging IsTb (NA) /Mtce 


Trnsl_ 
Tst_ Act Status 
Bsy_ Unit 0 A InSv (NA) RexFlt 
RTS_ Unit 1 I ManB /Mtc /Loadint: 200 
l Msg-Chan Net-Link MS-Link 
Disp_ PSP 0 1 
Unit 0 FPB 0 
SwAct_ Unit 1 FPB 1 
QueryDV_ 


IdMtce_ 


Hidden commands 


abtk 
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DEVICES(PSP) status codes 


The following table describes the status codes for the DEVICES(PSP) status 
display. 


Status codes DEVICES(PSP) menu status display 
Code Meaning Description 


Describes the state of control message channels used for messaging 
with the PSP card. For each PSP unit there is one control message 

channel to MS 0 and one to MS 1. The field may take any of the fol- 

lowing values. 


OK The cahannel is functioning properly. No faults have been detected. 


IsTb Channel is in-service trouble. 

ManB Channel is manual busy. 

SysB Channel is system busy. 

resource Required resources for the channel are unavailable. 
unequipped The channel is unequipped. 

testing The chamnel is undergoing tests. 


Common responses 


The following table provides explanations of the common responses to the 
DEVICES(PSP) commands. These responses will be produced by many of 
the commands under the DEVICES(PSP) level. This table will be referred 
to from the individual command descriptions to which it pertains. 


Responses for the DEVICES(PSP) commands 


MAP output Meaning and action 


Command initiated. Expected completion within <n> 


Meaning: Maintenance has started executing. The action should be completed in 
time <n> where: 


<n> is s specified amount of time. 
Action: None 


Command aborted. No HOST links exist to node. 


Meaning: Although the node itself has been datafilled, no links connecting it to its 
C-side node have been data filled, or made known to node or link 
maintenance. 


Action: Provide link data information and reenter the command. 
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Responses for the DEVICES(PSP) commands (continued) 
MAP output Meaning and action 


Command aborted. No communication path open to the node 


Meaning: The node is not accessible because of error in links connecting it to the 
maintenance host. 


Action: Determine whether problems exist with the link hardware. If so, correct 
the problem and reenter the command. 


Command aborted. Node is not responding. 


Meaning: Although the node is accessible, it is not responding to the command 
request. It is possible that the PSP has not yet been loaded or that it is 
experiencing problems in its software or hardware which are preventing 
it from communicating properly. 


Action: Determine whether problems exist with the load or in any of the node 
hardware. If so, correct the problem and reenter the command. If not, 
or if a software problem is suspected, contact next level of maintenance 
support. 


Command aborted. Maintenance in progress on node. 


Meaning: Other maintenance actions are being executed on the node as indicated 
by the Mtce flag on the unit’s MAP display. 


Action: reenter command when the */Mtce” flag on the units MAP display is 
removed. 


Command aborted. External abort received by maintenance. 


Meaning: command request has be terminated by the MAP abtk command. 


Action: None 
Command aborted. Software inconsistency. 
Meaning: Software received an unexpected return code or condition at some time 
during the command execution. A SWERR log is produced and the 


command is terminated. 


Action: This problem can only be fixed with the software update. Collect 
SERRS and other logs produced and submit them to technical support. 
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abtk 


Function 


Use the abtk command to abort maintenance action currently running on the 
posted programmable signal processor (PSP). 


abtk command parameters and variables 


Command Parameters and variables 


psp unit_num prompt wait reply 
msgch unit_num ms_num noprompt || nowait noreply 
netlink fob_num 

mslink 

fpb 


Parameters 
and variables Description 


This parameter causes the task for the PSP to be aborted. 


This parameter causes the task for the DS-512 paddle board to be aborted. 


This variable is the number of the DS-512 paddle board with a range of 0-1. 

This parameter causes the task for the message channels to be aborted. 

This parameter causes the task for the MS link to be aborted. 

This variable is the number of the message channel with a range of 0-1. 

This parameter causes the task for the ENET link to be aborted. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the abtk command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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abtk (continued) 


abtk command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered atthe MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
None 


Example 
The following table provides an example of the abtk command. 


Example of the abtk command 


Example Task, response, and explanation 


abtk PSP 1. 
where 


1 is the number of the PSP unit 


Task: Abort any maintenance task currently running on PSP unit 1. 


Response: AbTk 


Explanation: The current task running on PSP unit 1 is aborted. 
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abtk (end) 
Responses 


The following table provides explanations of the responses to the abtk 
command. 


Responses for the abtk command 
MAP output Meaning and action 
Command identifier for AbTk command is “AbTk”. 


Meaning: The task currently executing on the specified component has been 
aborted. 


Action: None 
Command failed. Current task could not be aborted. 


Meaning: The task currently executing on the specified component could not be 
aborted. 


Action: None 


Command aborted. No task to abort. 


Meaning: No maintenance task is currently executing on the specified component. 


Action: None 
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bsy 


Function 


Use the bsy command to place the card or link on the posted programmable 
signal processor (PSP) in the manual busy (ManB) state. 


bsy command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
netlink fpb_num noprompt || nowait noreply 
mslink 

fpb 


bsy noforce 
(continued) force 


Parameters 
and variables Description 


This parameter causes the DS-512 paddle board to be busied. 


This parameter will force an ISTb component to be busied immediately without 
waiting for current tasks to be completed. 


This variable is the number of the DS-512 paddle board with a range of 0-1. 
This parameter causes the message channels to be busied. 
This parameter causes the MS link to be busied. 


This variable is the number of the message channel with a range of 0-1. 


This default parameter, which is never entered, indicates that component will not 
be forced to the busy state immediately because the force parameter is not enterep. 


This parameter causes the enhanced network (ENET) link to be busied. 


This parameter prevents all prompting. 


This parameter suppresses all responses to the command action. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-528 DEVICES(PSP) level commands 
bsy (continued) 


bsy command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit with a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


The force parameter forces all work currently in progress on the unit to 
terminate immediately. Normally, work in progress continues to completion 
before the unit is made busy. The force parameter should only be issued 
when a rapid shutdown of the unit hardware is required. 


Example 
The following table provides an example of the bsy command. 


Example of the bsy command 
Example Task, response, and explanation 
bsy netlink 1 — 


where 


1 is the number of the the DS-512 paddle board to be busied. 


Task: Busy DS-512 paddle board number 1 in the posted PSP. 


Response: Command successful. Component has been manually 
busied. 


Explanation: The bsy command is successful. 
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bsy (end) 


Responses 


The following table provides explanations of the responses to the bsy 
command. 


Responses for the bsy command 


MAP output Meaning and action 


WARNING: 
The FORCE option should only be used when a fast shutdown of the hardware 


is desired. All work in progress will be terminated. Please confirm 
(“YES” or NO”) 


Meaning: The FORCE option must be verified. 


Action: Enter yes to continue the bsy command or no to stop it. 


Command aborted. Busying link will isolate node. 


Meaning: If the specified message link is busied, the posted PSP will be isolated 
because the other message link is not available. 


Action: None 


Command successful. Component has been manually busied. 
Meaning: The bsy command is successful. 


Action: None 


Command failed. Unit must be in-service or system-busy. 


Meaning: Unit cannot be manually busied unless it is either InSv or SysB. 


Action: None 
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disp 
Function 
Use the disp command to display a list of all PMs in a specified PM state. 


disp command parameters and variables 


Command Parameters and variables 
pm_state psp 


Parameters 
and variables Description 


This variable is one of the codes listed at the PM level description. 


This parameter is the PM node-type parameter for the PSP. 


Qualifications 
None 


Example 
The following table provides an example of the disp command. 


Examples of the disp command 


Example Task, response, and explanation 


disp bsy psp — 


Task: Display all busy PSPs. 


Response: Bsy PSP 0, 1 


Explanation: There is one busy PSP, PSP 0 unit 1. 
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D-532 DEVICES(PSP) level commands 
disp (end) 


Responses 


The following table describes the meaning and significance of responses to 
the disp command. 


Responses for the disp command 
MAP output Meaning and action 
pm_state PSP: NONE 


or 
pm_state PSP n, n 


Meaning: There is no PM in the specified state, or all in the state are listed, where 
pm_state is the state specified in the command. 


Action: None 
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idmtce 


Function 


Use the idmtce command to turn the LED on the specified card of the posted 
programmable signal processor (PSP) on or off. 


idmtce command parameters and variables 


Command Parameters and variables 


idmtce unit_num on prompt wait reply 
fob_num off noprompt| | nowait noreply 


Parameters 
and variables Description 


This parameter causes the DS-512 paddle board to be selected. 

This variable is number of the DS-512 paddle board with a range of 0-1. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter causes the LED to be turned off. 
This parameter causes the LED to be turned on. 


This default parameter, which is never entered, indicates prompts will be issued fo 
parameters and variables because the noprompt parameter is not entered. 


This parameter selects the PSP. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit with a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered atthe MAP until the abtk command has completed executing 
because the nowait parameter is not entered. 


Qualifications 


Because LEDs can be used to identify cards which should be pulled, the user 
will be prompted for verification before the command will be continued. 
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idmtce (continued) 


Example 
The following table provides an example of the idmtce command. 


Example of the idmtce command 


Example Task, response, and explanation 


idmtce psp 0 on. 
where 


0 is the PSP unit number. 
Task: Turn the LED of PSP unit 0 on. 
Response: Command successful. LED turned ON. 


Explanation: The LED of PSP unit 0 is on. 


Responses 


The following table provides explanations of the responses to the idmtce 
command. 


Responses for the idmtce command 


MAP output Meaning and action 


Command aborted. LED is already ON. (or OFF) 


Meaning: The command is not executed because the LED is already in the 
requested state. 


Action: None 


Command successful. LED turned ON. (or OFF) 


Meaning: The LED of the selected PSP unit is in the selected state. 


Action: None 
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idmtce (end) 


Responses for the idmtce command (continued) 
MAP output Meaning and action 
WARNING: 


The specified card is active. 
Please confirm (“yes” or “NO”). 


Meaning: The card is active. Because LEDs are used to identify cards that require 
replacement, the user must confirm the command ought to continue. 


Action: Respons with yes to turn the LED on, or no to abort the command. 
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post 


Function 


Use the post command to select a specific programmable signal processor 
(PSP) upon which action is to be performed by other commands. The post 
command must be used before entering commands swrg, trnsl, tst, bsy, rts, 
offl, loadpm, or querypm. 


post command parameters and variables 


Command Parameters and variables 


all pms 
site 
frame 
pm_state 


pm_type all 
pm_number...pm_number 


Parameters 
and variables Description 


all This parameter specifies all PSP be posted. 
allpms This parameter posts all PM types. 
frame This parameter posts all PM types within the specified frame. The range is 0-99. 


pm_number This variable specifies which PSP is to be posted. The range is 0-127. More tha 
one PSP is posted by entering their discrimination numbers separated by a blank 
space. 


This variable specifies a state. All pms in that state will be posted. 


This variable identifies the type of PM to be posted, which is the PSP. Ifthe PSP 
PM level is already accessed, the pm_type may be omitted. 


This variable posts all PM types at the site, where site is a four-character 
alphanumeric string. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 


limitations. 
e A PSP cannot be posted if it is not listed in Table LTCINV and 
LTCPSINV. 


e PSPs appear as a group on the display. From this group, specific PSPs 
may be posted by number. 
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post (continued) 


Example 


The post command displays vary depending on the PM type and the PM 
set. 


If parameters psp or allpms is entered alone with the post command, the 
menu commands on the new display level are used to select specific PM 
numbers. 


A list of current PM types, and their discrimination number ranges, can 
be displayed by entering the command disp. 


When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs present in the office configuration. For parameters that do not 
apply, one of several responses indicates it is ignored. 


The following table provides an example of the post command. 


Example of the post command 


Example Task, response, and explanation 


post psp all. 


Task: Post all PSPs. 


Response: <Display for first PSP> 


Explanation:All PSPs are posted. 
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post (end) 


Responses 


The following table describes the meaning and significance of responses to 
the post command. 


Responses for the post command 
MAP output Meaning and action 
NO PM POSTED 
Meaning: The PSP level is accessed without posting a specific PSP. 


Action: None 


pm_type x INSV LINKS_00S: CSIDE y PSIDE z 
UNIT 0: activity state 
UNIT 1: activity state MCTE 


Meaning: The status of the posted PSP is displayed below the PM status display 


where: 


pm_type PSP for the type of PM. 
x the discrimination number of the PM type. 
y the quantity of C-side links that are out of service. 
Z the number of P-side that are out of service. 
activity the activity of each unit, where: 
ACT _ is for an active unit, that is, actually 
processing calls 
INACT is for an inactive unit, that is, on standby for 
the active unit 
state one ofthe PM states. 
MTCE appears when a unit is undergoing maintenance actions 
(invoked manually or by the system). 


Action: None 
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querydv 


Function 


Use the querydv command to display specified information about the 
components of the programmable signal processor (PSP). 


querydv command parameters and variables 


Command Parameters and variables 


querydv psp unit_num dfit wait reply 
fpb fob_num flt nowait noreply 
idprom 
msgch unit_num ms_num dflt 
location 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that the standard 
information will be displayed because neither the flt or idprom parameters are 
entered. 


This parameter causes fault information to be displayed. 

This parameter causes the DS-512 paddle board to be queried. 

This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes IDPROM information to be displayed. 

This parameter causes the location of the queried component to be displayed. 
This parameter causes the message channels to be queried. 

This variable is number of the message channel and has a range of 0-1. 

This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This parameter causes the PSP to be queried. 


This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 
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querydv (continued) 


querydv command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the unit and with range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The querydv command is qualified by the following exceptions, restrictions, 
and limitations: 


e Default information is state information applying to the specified 
component. Although component states are constantly updated, this 
command is still necessary to make state information available to users 
of paper terminals and aMAP with the nodisp option. 


e Options can be used to see fault information for all components, and 
IDPROM information for cards. 


e If there are multiple faults for a card, the first fault description will be 
displayed, followed by its card list and the next fault followed by its card 
list. Faults are listed with the most critical faults appearing first. 
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querydv (continued) 


Examples 
The following table provides examples of the querydv command. 


Examples of the querydv command 


Example Task, response, and explanation 


querydv msgch 0 1. 
where 


0 is the unit number 
1 is the number of the message channel 


Task: Query the state of message channel unit O channel 1. 

Response: STATUS: INSV 

Explanation: Message channel unit O channel 1 is inservice. 
querydv psp idprom — 

Task: Query idprom for PSP currently posted. 

Response: IDPROM read: idl IDPROM expected: id2 


Explanation: Discrepancy in expected and detected proms displayed. 


Responses 


The following table provides explanations of the responses to the querydv 
command. 


Responses for the querydv command 


MAP output Meaning and action 


Command aborted. Component is unequipped. 


Meaning: There is nothing to report as the specified component is not equipped. 


Action: None 
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querydv (continued) 


Responses for the querydv command (continued) 


MAP output Meaning and action 


STATUS: <status> 


Meaning: The status of a card, link or message channel has been queried, and 
reported where: 


<status> is OFFL, MANB, SYSB, INSV, or ISTB. 
Action: None 


fault severity: card fault description 
<card_list> 


(for example) 


Non-critical fault: 3B error code detected. 
PSP:3 Floor:5 Row:bb Frame:7 shelf:2 slot:13f PEC:NTMX35AA 


Meaning: The flt parameter has been specified for a card. The information 
provided is as follows: 


fault severity no problem, noncritical or critical 
fault description a string describing the nature of the fault 


card list a list of possible faulty cards and their locations 
Action: None 


IDPROM read: idl IDPROM expected: id2 


Meaning: The idprom parameter was entered and the following information is 
provided: 


ACP: The type of ACP (LMX, PSP, HFT or others) 


Description ACP type, ACP number, slot, physical slot number, 
and system action. 
Action: None 
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querydv (end) 


Responses for the querydv command (continued) 


MAP output Meaning and action 


Description Floor Row Frame Shelf Slot PEC 

PSP Unit 0 87 AB 12 2 7F NTMX35AA 
PSP Unit 1 87 AB 12 8F NTMX35AA 
FPB 0 87 AB 12 7R NTMX3 9AA 
FPB 1 87 AB 12 8R NTMX3 9AA 


Meaning: The location of all devices for the posted PSP has been queried. 
Information is provided as follows: 


device: the type of device and RP number if applicable 


location: This consists of the fields, floor, row, frame, shelf, slot, 
anf PEC code. 
Action: None 
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DEVICES(PSP) level commands D-547 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DEVICES(PSP) level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DEVICES(PSP) level has changed to the previous menu level. 
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D-548 DEVICES(PSP) level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DEVICES(PSP) level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DEVICES(PSP) level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 
Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DEVICES(PSP) level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display ofthe DEVICES(PSP) level with the display of the next higher 
MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 
Use the rts command to return to service a card or link on the posted PSP. 


rts command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply (1) 
| noprompt || nowait | noreply | (2) 


rts (1) noforce 
(continued) force 


Parameters 
and variables Description 


This parameter will force an ISTb component to be returned to service without 
testing. 


This variable is number of the DS-512 paddle board and has a range of 0-1. 
This parameter causes the message channels to be returned to service. 
This variable is number of the message channel and has a range of 0-1. 


This default parameter, which is never entered, indicates that testing will be 
performed on component before being returned to service because the force 
parameter is not entered. 


This parameter prevents all prompting. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


This default parameter, which is never entered, indicates that responses will be 


displayed because the noreply parameter is not entered. 
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D-552 DEVICES(PSP) level commands 
rts (continued) 


rts command parameters and variables (continued) 


Parameters 
and variables Description 


unit_num This variable is the number of the PSP unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The component must be ManB or SysB before it can be returned to service. 


Example 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


rts msgch 0 1.1 
where 


0 is the unit number 
1 is the message channel number 


Task: Return message channel unit 0 channel 1 to service. 


Response: Command successful. Component has been returned 
to service. 


Explanation: The rts command successfully retuned the circuit to service. 
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rts (end) 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


WARNING: 
The FORCE option should only be used to RTS a component in the ISTb state 
(to avid testing). Please confirm (“YES” or “NO”). 


Meaning: The force parameter was entered with the RTS command. The system 
waits for response. 


Action: Enter yes to continue the command or no to terminate it. 
Command aborted. Component already inservice. 
Meaning: It is not possible to return to service a component already inservice. 
Action: None 
Command successful. Component has been returned to service. 
Meaning: Component has passed testing and been returned to service. 


Action: None 


Command successful. Component has been returned to in-service trouble. 


Meaning: The component failed testing but faults are not serious enough to affect 
service. 


Action: None 


Command failed. Failures occurred during component testing. 


Meaning: When an rts command is issued, diagnostics are performed on the 
component before returning it to service. Diagnostic failures have 
occurred and are reported. The errors are sever enough that the 
component cannot be returned to service. 


Take corrective maintenance action called for by indicated failure. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DEVICES(PSP) level commands D-555 
swact 


Function 


Use the swact command to cause the posted PSPs to switch the activity of 
the pairs of units (unit-0 and unit-1) from active to inactive. Units O and 1 
must be InSv or ManB. 


swact command parameters and variables 


Command Parameters and variables 


all test 


posted | notest | 


Parameters 
and variables Description 


This parameter simultaneously switches the activities of all XPMs of the same node 
type as the XPM in the current position of the posted set. 


This default parameter, which is never entered, indicates that will not undergo out 
of-service (OOS) testing, because the test parameter was not entered. 


This default parameter, which is never entered, indicates that only the currently 
posted PSP will be subject to the swact command, becasue the all parameter is net 
entered. 


This parameter causes a newly inactive unit to go through an RTS with full OOS 
diagnostics. 


Qualifications 
The swact command is qualified by the following exceptions, restrictions, 
and limitations: 
e Ifthe PSP is not ManB confirmation YES or NO is required. If the PSP 
1s ManB no confirmation is required. 


e Log PM181 is generated when swact is executed, identifying the 
newly-active unit. This log is for information only and no alarm is 
invoked. 


Examples 
Not currently available 
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swact 


Responses 


The following table describes the meaning and significance of responses to 
the swact command. 


Responses for the swact command 


MAP output Meaning and action 


A COLD SWACT WILL BE PERFORMED 


PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: The PSP is not ManB and the unlisted menu command warm swact is 


off. During a cold swact, both units are SysB and call processing is lost 
until the active unit is returned to service. A cold swact drops all calls. 


USER: If YES is entered the response is 
PSP pm_number SWACT PASSED 

which indicates that swact is executed. 

If NO is entered the response is 

ACTIVITY DROPPED 


SYSTEM: If YES is entered the newly-inactive unit becomes SysB and 
requires RTS to return it to the ready state. 


A WARM SWACT WILL BE PERFORMED AFTER 


DATA SYNC OF ACTIVE TERMINALS 
PLEASE CONFIRM “YES” OR “NO”): 


Meaning: The test option invokes a warm swact operation in which the newly 


Action: 


inactive unit is returned to service with full OSS diagnostic. 


SYSTEM: The user is prompted to confirm or reject command 
execution. If the user confirms, the warm swact is carried out. If the 
user rejects, the command is aborted. 


USER: Confirm or reject the command as required. 
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swact 


Responses for the swact command (continued) 


MAP output Meaning and action 


A WARM SWACT WILL BE PERFORMED AFTER 

DATA SYNC OF ACTIVE TERMINALS 

THE INACTIVE UNIT MAY NOT BE CAPABLE OF GAINING 
ACTIVITY. (PLEASE CHECK LOGS). DO YOU WISH FOR THE 
SWACT TO CONTINUE, REGARDLESS? 

PLEASE CONFIRM “YES” OR “NO”): 


Meaning: The pre-swact audit has determined that the unit should not assume 
activity and the warm swact operation should be terminated. 


Action: SYSTEM: The user is prompted to confirm or reject command 
execution. If the user confirms, the warm swact is carrier out. If the user 
rejects. the command is aborted. 


USER: Confirm or reject the command as required. 


PSP pm_number A WARM SWACT WILL BE PERFORMED 


Meaning: An XPM type of discrimination number nnn is to have the activity of its 
units switched. Calls in progress are allowed to complete. 


Action: None 
PSP pm_number SWACT PASSED 


Meaning: The activity of the two PSP units is switched, where pm_number is the 
discrimination number of the PSP. 


Action: None 


REQUEST INVALID 
INACT UNIT MUST BE INSV OR BOTH UNITS MUST BE MANB 


Meaning: The units cannot be switched because one or both are in the wrong 
state. 


Action: None 
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D-558 DEVICES(PSP) level commands 
swact (end) 


Responses for the swact command (continued) 


MAP output Meaning and action 


SWACT OPERATION NOT VALID ON OOS PM 


Meaning: When an XPM is in an out-of-service state (ManB, SysB, CBsy, or Offl), 
a switch of activity cannot occur. 


Action: SYSTEM: The activity display for the XPM(s) is blank. 
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trnsl 


Function 


Use the trnsl command to identify the components in the path of the physical 
link connections to the ENET and MS and the message channel connections 
to the MS for the posted CFI node. 


trnsl command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num 


netlink fob_num 
mslink 


Parameters 
and variables Description 


fob_num This variable is number of the DS-512 paddle board and has a range of 0-1. 


msgch This parameter causes the message channels to be selected. 

mslink This parameter causes the MS link to be selected. 

ms_num This variable is number of the message channel and has a range of 0-1. 
netlink This parameter causes the ENET link to be selected. 


unit_num This variable is the number of the unit and has a range of 0-1. 


Qualifications 
None 
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trnsl (continued) 


Example 
The following table provides an example of the trnsl command. 


Examples of the trnsl command 


Example Task, response, and explanation 


trnsl msgch 0 1.1 
where 


0 is the CFI unit number 
1 is the message switch number 


Task: Display location information for the control message channel from 
CFI 0 to message switch 1. 


Response: FPB Description of MS links 
1 FPBO / MS 1, Shelf 0, Chain 18, Link 1 


Explanation: Information for the control message channel from CFI 0 to 
message switch 1 is displayed. 


Responses 


The following table provides explanations of the responses to the trnsl 
command. 


Responses for the trnsl command 


MAP output Meaning and action 


Unit MsgCh Description of Message Channels 
0 0 CFI 12, Unit 0 / MS 0, Shelf 0, Chain 1 
vis FPB 0, Link 1 
CFI 1 Unit 0 / MS 1, Shelf Chain 1 
FPB Link 1 
CFI 1 E 0%./ 0, Shelf Chain 1 
FPB Link 1 
CFI 1 it 0 / 0, Shelf Chain 1 
i FPB Link 1 


Meaning: This is response to a trnsl msgch command. The first line indicates that 
the control message channel from unit 0 of the CFI to MS 0 goes by FPB 
0 link 1 to MS 0, Shelf 0, card 18, Link 1, MPLH Port 3. 


Action: None 
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trnsl (end) 
Responses for the trnsl command (continued) 


MAP output Meaning and action 


FPB Description of Network Links 
O FPBO / ENET Plane 0, Shelf 1, 


Slot 11, Link 3 
1 FPBl / ENET Plane 1, Shelf 1, 


Slot 11, Link 3 


Meaning: This is the response to the trnsl netlink command. The Network link on 
fiber paddle board O terminates on ENET plane 0, shelf 1, slot 11 and 


link 3. The Network link on fiber paddle board 1 terminates on ENET 
plane 1 shelf 1, slot 11 and link 3. 


None 


FPB Description of MS links 
O FPBO / MS 0, Shelf 0, Chain 18, 


Link 1 
1 FPBO / MS 1, Shelf 0, Chain 18, 


Link 1 


Meaning: This is the response for the trnsl mslink command. The MS link on fiber 
paddle board 0 terminates on MS 0, plane 0, card 18, link 1. The MS 
link on fiber paddle board 1 terminates on MS 1, plane 0, card 18, link 1. 


Action: None 
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tst 


Function 
Use the tst command to test specified message channel and display the 
results. 


tst command parameters and variables 


Command Parameters and variables 


msgch unit_num ms_num prompt wait reply 
noprompt || nowait noreply 


Parameters 
and variables Description 


This parameter causes the message channels to be tested. 


This parameter causes the MS link to be tested. 

This variable is number of the message channel and has a range of 0-1. 

This parameter prevents all prompting and defaults all answers to prompts to yes. 
This parameter suppresses all responses to the command action. 


This parameter allows additional commands to be entered at the MAP without 
waiting for the command to complete executing. 


This default parameter, which is never entered, indicates that prompts will be issued 
for parameters and variables because the noprompt parameter is not entered. 


reply This default parameter, which is never entered, indicates that responses will be 
displayed because the noreply parameter is not entered. 


unit_num This variable is the number of the unit and has a range of 0-1. 


wait This default parameter, which is never entered, indicates that additional command 
cannot be entered at the MAP until the command has completed executing 
because the nowait parameter is not entered. 


Qualifications 
The kind of tests that will be run is determined by wether the component is 
inservice or out-of-service. 
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tst (continued) 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


tst msgch 0 1.1 
where 


0 is the PSP unit number 
1 is the message switch number 


Task: Test message switch number one on PSP unit 0. 
Response: Command passed. Component passed all tests. 


Explanation: The test of message switch number one on PSP unit O passed. 


Responses 


The following table provides explanations of the responses to the tst 
command. 


Responses for the tst command 


MAP output Meaning and action 


Specified card is unequipped. Card in slot will be tested anyway. 
Pleas confirm (“YES“ or “NO”). 


Meaning: The card to be tested is not equipped. The system waits for verification. 
Action: To test the unequipped card enter yes else enter no. 

Command aborted. Component already under test. 
Meaning: It is impossible to test acomponent already being tested. 


Action: None 


Command aborted. Component is offline. 


Meaning: A component must be on line to be tested. 


Action: None 
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tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


Command passed. Component passed all tests. 
Meaning: Test specified passed. 


Action: None 


Command failed. Component failed test. 


Meaning: The specified component failed a test issued against it. The reason for 
the failure is displayed. 


Action: None 
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D-567 


DIRP level commands 


Use the device independent recording package (DIRP) level of the MAP to 
access the commands used to control the files and recording volumes of the 
DIRP. 


Accessing the DIRP level 
To access the DIRP level, enter the following from the CI level: 
mapci;mtc;iod;dirp - 


DIRP commands 


The commands available at the DIRP MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DIRP commands 


Command 


audit 
cleanup 
close 
dmnt 


mnt 


query 


quit 


revive 


rotate 


rsetvol 
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DIRP menu 


The following figure shows the DIRP menu and status display. The insert 


with hidden commands is not a visible part of the menu display. 
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DIRP status codes 
None 


IOD Net PM ccs 
IOD 
IOC Or iE. age 3 
STAT 
DIRP: XFER: DPPP 
SLM NX25: MLP 


Hidden commands 


cleanup 
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revive 


Trks 


DPPU: 


Ext 


NOP 


APPL 


DIRP level commands D-569 
audit 


Function 


Use the audit command to manually initate a specific audit procedure. The 
audit command also resets the ssys E minor alarm to indicate that an 
emergency rotate has been acknowledged. 


audit command parameters and variables 
Command Parameters and variables 
subsystem 


Parameters 
and variables Description 


This variable is the name of one of the DIRP contributing subsystems to be 
audited. 


Qualifications 


The audit command is qualified by the following exceptions, restrictions, 
and limitations: 


e The audit initated by this command is the same subsystem audit 
procedure that is normally conducted by DIRP once each hour. 


e Typically, this command is used when file space has been created 
manually by deletions or erasures. The audit command makes the 
system aware of the new resources. 


e The subsystem name used with this command must be the name of a 
subsystem identified in table DIRPSYS. 


e This command clears the syss E alarm after prompting. The prompt 
should not be responded to without some attempt at investigating the 
problem. If you answer no to the prompt, the indicator will remain set, 
and the audit will run. 


e The results of this command are displayed by means of logs, and not on 
the MAP screen. 
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audit (continued) 


Example 
The following table provides an example of the audit command. 


Example of the audit command 
Example Task, response, and explanation 


audit ama — 
where 


ama is the subsystem to be audited 


Task: Audit the automated message accounting (AMA) subsystem. 


Response: SENDING REQUEST TO SUBSYSTEM 
DO YOU WANT THE SUBSYSTEM EMERGENCY INDICATOR 
TURNED OFF? 
Please confirm (“YES” or “NO”): 


Explanation: The audit is sent. The system requests confirmation on turning off 
the emergency indicator. 


Responses 
The following table provides explanations of the responses to the audit 


command. 


Responses for the audit command 


MAP output Meaning and action 


COULD NOT SEND TO SUBSYSTEM, PLEASE TRY AGAIN LATER 
Meaning: The audit command could not be sent to the subsystem. 


Action: Try the audit command again later. 


REQUEST SENT TO SUBSYSTEM, CHECK DIRP LOG FOR DETAILS 


Meaning: The request for an audit is sent to the subsystem. The results are 
shown in the DIRP logs. 


Action: None 
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audit (end) 


Responses for the audit command (continued) 
MAP output Meaning and action 
SENDING REQUEST TO SUBSYSTEM 


DO YOU WANT THE SUBSYSTEM EMERGENCY INDICATOR TURNED OFF? 
Please confirm (“YES” or “NO”): 


Meaning: The audit is sent. The system requests confirmation on turning off the 
emergency indicator. 


Action: Enter yes to have the emergency indicator turned off. Enter no to 
continue with the audit without turning the emergency indicator off. 


SUBSYSTEM HAS NOT REPLIED WITHIN 30 SEC LIMIT. 
WATCH DIRP LOGS FOR RESULTS. 
IF NONE FOUND, TRY AGAIN LATER. 


Meaning: Confirmation from the subsystem was not received within the timeout 
limit. The system load may be heavy enough to have interfered with 
proper execution of the command. 


Action: Check the DIRP logs. Repeat the audit command if the requested audit 
results do not appear in the logs. 


UNKNOWN SUBSYSTEM NAME 
Meaning: The subsystem name used with the audit command was incorrect. 


Action: Check the subsystem name and retry the audit command with a correct 
subsystem name. 
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cleanup 


Function 


Use the cleanup command to rename terminated removed (R) files and to 
delete closed parallel files.. 


cleanup command parameters and variables 


Command Parameters and variables 


cleanup all 
subsystem 


yyyy mm dd 
yyyy mm dd 
yyyy mm dd 
yyyy mm dd 
yyyy mm dd 


subsystem_name 
pool pool_name 
volume volume_name 

file file_name 


Parameters 
and variables 


all 


file 


file_name 


pool 


pool_name 


subsystem 


subsystem_name 


volume 


volume_name 


yyyy mm dd 


Description 


This parameter directs the system to rename all terminated R files on all disk 
volumes in table DIRPPOOL. 


This parameter directs the system to rename a terminated R file, or erases a 
parallel file. 


This variable is the file name. 


This parameter directs the system to rename all terminated R files in the current 
pool of the listed subsystem in table DIRPPOOL. 


This variable is the pool name. 


This parameter directs the system to rename all terminated R files in the current 
pool of the listed subsystem. 


This variable is the subsystem. 


This parameter directs the system to rename all terminated R files in the regular 
disk volume. 


The volume name must be in your user directory. 


This variable is the year, month, and day used to determine which regular files to 
terminate. This field is optional and does not apply to parallel files. The range 
of years is 1976-3000; the range of months is 1-12; the range of days is 1-31. 
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D-574 DIRP level commands 
cleanup (continued) 


Qualifications 


The cleanup command is qualified by the following exceptions, restrictions, 
and limitations: 


The cleanup command only affects terminated R and closed parallel files 
recorded under DIRP onto disk 


For the cleanup subsystem and cleanup pool command strings, the 
subsystem or pool must be listed in table DIRPSSYS or table 
DIRPPOOL. 


The cleanup all command string renames only those files on volumes 
listed in table DIRPPOOL 


A file or a volume can be cleaned up without its respective pool or 
subsystem being listed in table DIRPSSYS or table DIRPPOOL. 


If a volume is listed in table DIRPPOOL, it must be in a ready state for 
cleanup to operate on it. When a file is ready for recording and has no 
errors, it is in a ready state. 


When a cleanup all, cleanup pool, or cleanup subsystem command string 
is entered, a check is made for pools whose device type is disk and that 
have no volumes allocated to them. When such pools are found, a 
message of no volumes in pool is displayed. 


The year, month, and date field is used to determine which R files are 
considered terminated for the cleanup command. If no date is entered, 
the file is considered terminated if the file date added to the retention 
period in table DIRPSSYS results in a date before the current date. If a 
date 1s entered, all files whose file date is before the date entered with 
the cleanup command are terminated. 


Because the concept of termination does not apply to parallel files, a date 
cannot be entered when cleanup is used to erase parallel files. 


The software cannot prevent an attempt to cleanup a demounted volume 
that has been used for parallel recording. However, the operation will 
not affect the parallel file on the volume. Therefore, the cleanup of 
demounted parallel volumes has no effect on any parallel files. 


For backward compatibility, the cleanup file command string allows the 
user to erase files named dirpparallel or dirpparallel_<ssys>. These 
name formats were used in previous DMS software releases. 
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cleanup (continued) 


Example 
The following table provides an example of the cleanup command. 


Example of the cleanup command 


Example Task, response, and explanation 


cleanup file r921212085608ama — 
where 


r921212085608ama is the file name of a parallel file to be deleted 


Task: Delete the specified closed parallel file. 

Response: Deleting parallel file B901212085608AMA 
DO YOU WISH TO CONTINUE? 
PLEASE CONFIRM (“YES’ OR “NO”): 


Explanation: The system prompts for confirmation before deleting the file. 


Responses 


The following table provides explanations of the responses to the cleanup 
command. 


Responses for the cleanup command 


MAP output Meaning and action 


AMAPOOL is not defined in table DIRPPOOL 


Meaning: The pool name specified is not in table DIRPPOOL. The system aborts 
the command. 


Action: Check the pool name, and retry the cleanup command with a valid pool 
name. 


ATTEMPT TO ERASE FILE R921212085608AMA FAILED. 
RETURN CODE: <value> 
<message> 


Meaning: The system experienced a file system error. The file may not have been 
erased. A return code and a message about the nature of the error 
replace <value> and <message> in the response. 


Action: Contact maintenance support personnel. 
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cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


LEANUP of parallel pools is not supported. 
LEANUP FILE command will erase parallel files. 


Meaning: The system will not allow the cleanup command to be used on a parallel 
DIRP pool. 


Action: Demount the volume and then use the cleanup file command string on 
the individual parallel files. 


CLEANUP of parallel volumes is not supported. 
LEANUP FILE command will erase parallel files. 


Meaning: The system will not allow the cleanup command to be used on a parallel 
DIRP volume. 


Action: Demount the volume and then use the cleanup file command string on 
the individual parallel files. 


Cannot CLEANUP a file on a volume still mounted to DIRP. 


Meaning: You attempted the cleanup command on a parallel file before 
demounting the parallel volume it was on. 


Action: Demount the volume and then use the cleanup file command string on 
the individual parallel file. 


Cannot CLEANUP volumes not in ready state. 


Meaning: You attempted the cleanup command on a volume that is not in the 
ready state or on a file in a volume that is not in the ready state. 


Action: Determine why the volume is not in the ready state. Contact 
maintenance support personnel if appropriate. 


CLEANUP works only on disk pools. 
Meaning: The cleanup command will not work on the specified pool. 


Action: Retry the cleanup command with valid parameters. 
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DIRP level commands D-577 
cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


Could not get volume information. 
RETURN CODE: <value> 
<message> 
Meaning: The system encountered a file system error. The file was not erased or 
renamed. A return code and a message about the nature of the error 
replace <value> and <message> in the response. 


Action: Contact maintenance support personnel. 
Date format is: yyyy mm dd 
Meaning: You entered an incorrect variable. 


Action: Retry the command with variables within the correct ranges. 


Deleting parallel file DIRPPARALLEL_ssys 
Do you wish to continue? 
Please confirm (“YES” or “NO”): 
Meaning: The system prompts for confirmation before deleting the file. 
Action: Enter yes to continue deleting the file. Enter no to abort the command. 
DIRPPARALLEL_ssys has been erased. 


Meaning: The file was erased 


Action: None 


DIRPPARALLEL_ssys is not closed. 


Meaning: The specified file cannot be renamed or deleted because the file is being 
used by a subsystem. 


Action: None 
Invalid number of days for Feb. 
Meaning: The system will only take valid dates. 


Action: Check the date, and retry the cleanup command. 
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D-578 DIRP level commands 
cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


volume DOOOAMA: 
2K DIRP blocks were renamed 
of those blocks are available to DIRP and expired. 


Meaning: The cleanup command has finished renaming the R files on this volume. 
The number of 2-K DIRP blocks renamed and the number of those 
blocks that are expired and available to DIRP is given in the response. 


Action: None 

cutoff date is allowed when deleting parallel files. 
Meaning: The system will not allow you to enter a date when erasing a parallel file. 
Action: Retry the cleanup command without a date variable. 

volumes in AMAPOOL. 
Meaning: There are no volumes allocated to the named pool. 
Action: None 

R91212085608AMA is not a valid parallel or “R” file name. 

Meaning: The file specified to be changed or removed is not a valid parallel file 


name or a valid DIRP-generated R file name. The system displays this 


message if a file was selected from a subsystem that has been removed 
from DIRP. 


Action: Check the name of the specified file, and retry the cleanup command 
with a valid file name. 


R921212085608AMA IS NOT ON ANY VOLUME IN DIRPPOOL 
DO YOU WISH TO CONTINUE? 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: The file specified is not present on any volume in table DRIPPOOL. 


Action: Check the name of the file. Enter yes to continue with the cleanup 
command. Enter no to abort the command. 
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DIRP level commands D-579 
cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


R921212085608AMA IS NOT A READY DISK VOLUME IN DIRPPOOL. 
DO YOU WISH TO CONTINUE? 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: The volume containing the specified file is not in table DIRPPOOL, or 
the volume specified is not in table DIRPPOOL. 


Action: Check the name of the file or the volume. Enter yes to continue with the 
cleanup command. Enter no to abort the command. 


R921212085608AMA is not terminated. 


Meaning: The file cannot be renamed because its retention period in table 
DIRPSSYS has not been exceeded, or its file date is prior to the date 
entered in the command string. 


Action: Use the date variable with the cleanup command if the file must be 
renamed. Using a date in the future will ensure that the file is 
terminated. 


R921212085608AMA is renamed P921212085608AMA: 
12 2K DIRP blocks were renamed 
12 of those blocks are available to DIRP and expired. 


Meaning: The cleanup command has finished renaming the R file. The number of 
2-K DIRP blocks renamed and the number of those blocks that are 
expired and available to DIRP is given in the response. 


Action: None 
R921212085608AMA is renamed P921212085608AMA: 


12 2K DIRP blocks were renamed 
12 of those blocks are in expired P files 


Meaning: The cleanup command has finished renaming the R file. The number of 
2-K DIRP blocks renamed and the number of those blocks that are in 
expired P files is given in the response. 


Action: None 
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D-580 DIRP level commands 
cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


Renaming “R” files with file dates 30 JAN 1991 
Renaming or deleing file DIRPPARALLEL_ssys 

Do you wish to continue? 

Please confirm (“YES” or “NO”): 


Meaning: The R files with file dates equal to or prior to the displayed date will be 
renamed. 


Action: Enter yes to continue with the cleanup command. Enter no to abort the 
command. 


Subsystem must be currently recording on disk 
DIRP is not recording to disk. 


Meaning: DIRP is not recording to disk in this office. The cleanup command 
cannot be used. 


Action: None 


The retention period in which DIRPSSYS will be used 
to determine which “R” files are terminated. 
Renaming file R921212085608AMA 

Do you wish to continue? 

Please confirm (“YES” or “NO”): 


Meaning: Either you did not enter a date, or the date you entered included an 
incorrect year or incorrect characters. The system will use the retention 
period in table DIRPSSYS to determine which R files can be terminated. 


Action: Enter yes to continue with the cleanup command. Enter no to abort the 
command. 
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cleanup (continued) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


The retention period in DIRPSSYS will be used 

to determine which R files are terminated. 

The time required to complete cleanup depends on the number of volumes 
affected and the number of R files in those volumes. 

Do you wish to continue? 

Please confirm (“YES” or “NO”): 


Meaning: The to be terminated are determined by the retention period datafilled in 
table DIRPSSYS. The length of time to complete a cleanup of these 


files is determined by the number of volumes affected and the number of 
R files on those volumes. 


Action: Enter yes to continue with the cleanup command. Enter no to abort the 
command. 


Unable to complete scan for R files on DOOOAMA 
Return code: <value> 
<message> 


Meaning: The system experienced a file system error before it could complete a 
scan for R files. The files may not have been renamed. A return code 
and a message about the nature of the error replace <value> and 
<message> in the response. 


Action: Contact maintenance support personnel. 


Unable to get file infor for R921212085608AMA 
Return code: <value> 
<message> 


Meaning: The system experienced a file system error when trying to rename a file. 
The file may not have been renamed. Areturn code and a message 
about the nature of the error replace <value> and <message> in the 
repsonse. 


Action: Contact maintenance support personnel. 
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D-582 DIRP level commands 
cleanup (end) 


Responses for the cleanup command (continued) 


MAP output Meaning and action 


Unknown subsystem name. 
CAMBOT is not a valid subsystem. 


Meaning: The subsystem name entered is not known to DIRP. 


Action: Check the subsystem name, and retry the command with a valid 
subsystem. 
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close 
Function 


Use the close command to manually close specific DIRP files. 


close command parameters and variables 


Command Parameters and variables 


subsystem | active 
stdby standby num 


Parameters 
and variables Description 


active This parameter directs the system to close the subsystem’s active main file. 


standby_num This variable specifies the file to close. Valid entries are 1-3. 


stdby This parameter directs the system to close one of the subsystem’s standby main 
files. 


subsystem This variable specifies the subsystem. 


Qualification 


The close command is qualified by the following restriction: the subsystem 
name used with this command must be the name of a subsystem identified in 
table DIRPSYS. 
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D-584 DIRP level commands 
close (continued) 


Example 
The following table provides an example of the close command. 


Example of the close command 


Example Task, response, and explanation 


close ama active . 
where 


ama is the subsystem 


Task: Close the main active file on the automatic message accounting 
(AMA) subsystem. 


Response: WARNING-A ROTATE WILL BE DONE (IF NECESSARY) 
BEFORE CLOSING THE ACTIVE FILE. 
SENDING REQUEST TO SUBSYSTEM 
Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before sending the close 
command to the subsystem. 


Responses 


The following table provides explanations of the responses to the close 
command. 


Responses for the close command 


MAP output Meaning and action 


COULD NOT SEND TO SUBSYSTEM, PLEASE TRY AGAIN LATER 


Meaning: The close command could not be sent to the subsystem. 


Action: Try the close command again later. 


REQUEST SENT TO SUBSYSTEM, CHECK DIRP LOG FOR DETAILS 


Meaning: The request for a close was sent to the subsystem. The results are 
shown in the DIRP logs. 


Action: None 
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DIRP level commands D-585 
close (end) 


Responses for the close command (continued) 


MAP output Meaning and action 


SENDING REQUEST TO SUBSYSTEM 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before closing the file. 


Action: Enter yes to close the file. Enter no to abort the command. 


SUBSYSTEM HAS NOT REPLIED WITHIN 30 SEC LIMIT. 
WATCH DIRP LOGS FOR RESULTS. 
IF NONE FOUND, TRY AGAIN LATER. 


Meaning: Confirmation from the subsystem was not received within the timeout 
limit. The system load may be heavy enough to have interfered with 
proper execution of the command. 


Action: Check the DIRP logs. Repeat the close command if the requested close 


results do not appear in the logs. 
UNKNOWN SUBSYSTEM NAME 
Meaning: The subsystem name used with the close command was incorrect. 


Action: Check the subsystem name and retry the close command with a correct 
subsystem name. 


WARNING-A ROTATE WILL BE DONE (IF NECESSARY) BEFORE CLOSING THE ACTIVE 
FILE. 

SENDING REQUEST TO SUBSYSTEM 

Please confirm (“YES” or “NO”): 


Meaning: The volume to be closed is in the active position. A file rotation is 
required before the file can be closed. 


Action: Enter yes to rotate the file and close it. Enter no to abort the command. 
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DIRP level commands D-587 
dmnt 


Function 


Use the dmnt command to make the specified volume available to the 
specified subsystem by demounting the volume from a DIRP pool. 


dmnt command parameters and variables 
Command Parameters and variables 


subsystem volume/device paralel 


Parameters 
and variables Description 


paralel This parameter directs the system to demount the volume from the subsystem’s 
parallel pool. This parameter is optional. 


subsystem This variable is the subsystem name. 


volume/device This variable is the volume or device name. 


Qualifications 


The dmnt command is qualified by the following exceptions, restrictions, 
and limitations: 


e This command demounts volumes by updating the datafill of table 
DIRPPOOL. Responses and warning messages not included here may 
be generated from these updates. 


e Reference to the volume can be by number or by volume name. If a 
number is used, the system assumes that it is magnetic tape drive 
(MTD), and deletes the volume current mounted on the MTD of the 
number specified. 


e When entering this command using menu numbers, enter a space before 
the drive number. For example, the dmnt ama 1 command string could 
be entered as 59 1. 
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D-588 DIRP level commands 
dmnt (continued) 


Example 
The following table provides examples of the dmnt command. 


Example of the dmnt command 


Example Task, response, and explanation 


dmnt ama 1. 
where 


ama is the subsystem 
1 is the number of the volume 


Task: Demount volume 1 on the automatic message accounting (AMA) 
subsystem. 


Response: Updating volume information for 
DOOOAMP1: Volume 1 in Parallel pool 62, AMAPARL 
Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before demounting the 
volume. 


Responses 


The following table provides explanations of the responses to the dmnt 
command. 


Responses for the dmnt command 
MAP output Meaning and action 


Error updating information for AMA 1-could not find the requested volume 
Meaning: The volume specified in the command is not mounted. 


Action: Check the volume name and retry the dmnt command. 


Parallel pool is not defined for subsystem AMA 


Meaning: You attempted to demount a parallel volume for a subsystem without a 
parallel DIRP pool being defined for that subsystem. The dmnt 
command is aborted. 


Action: None 
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DIRP level commands D-589 
dmnt (continued) 


Responses for the dmnt command (continued) 


MAP output Meaning and action 


Unknown subsystem name 


Meaning: The subsystem specified in the dmnt command was not recognized by 
DIRP. 


Action: Check the subsystem name and try the dmnt command again with a 
valid subsystem name. 


Updating volume information for 
DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before updating the volume 
information. Any open files on the volume will be closed as soon as 
possible, then the volume will be deleted from the pool to which it was 
assigned. If the office is equipped with the remote data polling feature, 
entries for files contained on volumes deleted in this fashion are also 
deleted from table DIRPHOLD. Total parallel retention for the 
subsystem may be reduced. 


Action: None 


Volume DOOOAMPO will be taken out of DIRP as soon as possible. 
Meaning: The system deletes the volume. 


Action: Wait for the log report that says the volume has been deleted, or use the 
query command to query the volume status. 


WARNING-This update may affect the active file 
Updating volume information for 

DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 
Please confirm (“YES” or “NO”): 


Meaning: The volume to be demounted is in the active position. 


Action: Enter yes to rotate the volume out of the active position, close it, and 
demount it. Enter no to abort the command. 
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D-590 DIRP level commands 
dmnt (end) 


Responses for the dmnt command (continued) 


MAP output Meaning and action 


WARNING-This update may affect the currently recording parallel file 
Updating volume information for 

DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 

Please confirm (“YES” or “NO”): 


Meaning: You are attempting to demount a parallel volume that contains the 
currently recording parallel file. If other ready volumes are in the pool, a 
manual rotate will occur after the demount operation is completed. 


Action: Enter yes to continue with the command. Enter no to abort the 
command. 
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DIRP level commands D-591 
mnt 


Function 
Use the mnt command to assign a recording volume to a subsystem. 


mnt command parameters and variables 
Command Parameters and variables 


subsystem volume/device paralel volume_no 


Parameters 
and variables Description 


paralel This parameter directs the system to demount the volume from the subsystem’s 
parallel pool. This parameter is optional. 


subsystem This variable is the subsystem name. 
volume/device This variable is the volume or device name. 


volume _no This variable is the volume number where the volume should be placed. Valid 
entries are 0-23. 


Qualifications 


The mnt command is qualified by the following exceptions, restrictions, and 
limitations: 


e This command mounts volumes by updating the datafill of table 
DIRPPOOL. Responses and warning messages not included here may 
be generated from these updates. 


e The subsystem name used with this command must be the name of a 
subsystem identified in table DIRPSYS. 


e Reference to the volume can be by number or by volume name. If a 
number is used, the system assumes that it is magnetic tape drive 
(MTD). If the volume is a tape, the system does a mount and format 
operation, prompting for confirmation as required. If the volume is a 
tapex, the volume is assigned, but the formatting procedure is not done. 
If the volume is specified by name, the volume must be correctly 
formatted and ready for recording. 


e When entering this command using menu numbers, enter a space before 
the drive number. For example, the mnt ama 1 command string could be 
entered as 59 1. 


e The mnt command will mount a parallel disk volume if it is properly 
preformatted. 
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D-592 DIRP level commands 
mnt (continued) 


e If the volume has been used before to record parallel subsystem data, 
and was then demounted, it can be remounted to the parallel pool of the 
same subsystem without being preformatted. 


Example 
The following table provides an example of the mnt command. 


Example of the mnt command 


Example Task, response, and explanation 


mnt ama 1. 
where 


ama is the subsystem 
1 is the number of the volume 


Task: Mount volume 1 on the automatic message accounting (AMA) 
subsystem. 


Response: Updating volume information for 
DOOOAMP1: Volume 1 in Parallel pool 62, AMAPARL 


Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before mounting the volume. 


Responses 


The following table provides explanations of the responses to the mnt 
command. 


Responses for the mnt command 
MAP output Meaning and action 
Formatting tape as Tl 


First file = B921127123108AMA, Created Nov 27 1992, Expires Feb 27 1993 
Enter first file to continue 


Meaning: A tape volume was mounted. 


Action: Enter the first file name. 
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DIRP level commands D-593 
mnt (continued) 
Responses for the mnt command (continued) 
MAP output Meaning and action 
Parallel pool is not defined for subsystem AMA 


Meaning: You are attempting to mount a parallel pool for a subsystem without a 
parallel DIRP pool being defined for the subsystem. 


Action: Create a parallel DIRP pool in table DIRPPOOL and assign the pool to 
the subsystem by changing parlpool in table DIRPSSYS appropriately 


Parallel recording is not currently active for ssys. 
Recording may begin immediately on this volume. 
Updating volume information for 

DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before opening a parallel file for 
recording. The subsystem that the volume is allocated to does not 
currently have a parallel file open for recording. This may affect the 
parallel retention period because this volume will become the current 
parallel volume. Any subsequent rotation will occur to the first ready 
volume behind this one in the parallel volume lineup. 


Action: None 
Updating volume information for 
DOOOAMPO: Volume O in Parallel Pool 62, AMAPARL 


Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before updating the volume 
information when mounting a volume. 


Action: Enter yes to continue with the mount command. Enter no to abort the 
command. 


Volume DOOOAMA allocated 


Meaning: The system allocates the volume to the specified subsystem. 


Action: None 
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D-594 DIRP level commands 
mnt (end) 


Responses for the mnt command (continued) 


MAP output Meaning and action 


Volume DOOOAMA in parallel pool already occupied. 


Meaning: You are attempting to mount a parallel volume in the subsystem’s 
parallel pool in the same position in the volume lineup as another 
volume. 


Action: Determine which slots are available by using the query command or by 
referencing the subsystem’s parallel pool in table DIRPPOOL. 


Volume DOOOAMA is not available 


Meaning: Either the volume specified does not exist, or the device on which it 
records is out of service. 


Action: Check the volume name. Retry the command with a valid volume name, 
or check the device on which the volume records. 


WARNING-Parallel file on volume has been used before. 
Updating volume information for 

DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before overwriting files. The data 
previously recorded to the file will be overwritten if this volume is 
mounted. 


Action: Enter yes to continue with the mnt command. Enter no to abort the 
command. 


WARNING-Volume needs preformatting for parallel recording. 
Updating volume information for 

DOOOAMPO: Volume 0 in Parallel pool 62, AMAPARL 

Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before preformatting the disk. The 
preformat operation should be done during a low-volume traffic period. 
The volume being formatted should be on a disk device that is not 


actively being used to record regular or parallel data from any 
subsystem. 


Action: Enter yes to continue the mnt command. Enter no to abort the 
command. 
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query 


Function 


Use the query command to display the current status of recording files for 
the specified subsystem. 


query command parameters and variables 


Command Parameters and variables 


subsystem | files 
all 
volumes 
space 


Parameters 
and variables Description 


This parameter directs the system to display information relating to both the 
volume and files of the subsystem. 


This default parameter directs the system to display information relating to the 
subsystem files. 


This parameter provides detailed information on the recording space that is 
available in all volumes allocated to a specific subsystem. This information is 
only applicable to disk volumes. 


This variable specifies the name of the contributing subsystem for which data is 
to be displayed. 


This parameter displays information relating to the subsystem volumes. 


Qualifications 
The query command is qualified by the following exceptions, restrictions, 
and limitations: 


e The subsystem name used with this command must be the name of a 
subsystem identified in table DIRPSSYS. 


e The data line containing variable data has ***YES*** or NO beneath 
the field header EMERGENCY. Other data values are examples only. 


e The input/output controller JOC) number and card number are not 
displaying for system load module (SLM) volume. 


e Space information is only provided if either the regular or parallel pools 
of the subsystem have a device type of disk. The space information is 
not applicable to tape, tapex, or dpp volumes. 
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D-596 DIRP level commands 
query (continued) 


Example 
The following table provides an example of the query command. 


Example of the query command 
Example Task, response, and explanation 


query ama all — 
where 


ama is the subsystem to be queried 


Task: Query the automated message accounting (AMA) subsystem. 


Response: 


SSNAME SSNO SEONO ROTATES POOLNO PARLPOOL EMERGENCY 
AMA 0 1 2 0 36, KFRYESFFR 


FILES(S) STATE VOLUME RECOUNT BLOCK E V V_B VLID FNUM FRN# 
ACTIVE AVAIL DOOOAMAO 75 30 1 NO A006 0015 2058 
STANDBY1 AVAIL DO10AMAO 75 2 E 2 NO A004 0011 2034 


PARALLEL 
FILE STATE VOLUME BLOCK E V V_B VLID FILES 
B120812302201AMA AVAIL DO40AMPO 1 0 V NO 2813 S1,S3 


REGULAR VOLUMES 

VOL# VOLNAME STATE IOC CARD VOL FSEG ROOM VLID FILES 
22 DOLOAMA READY 1 1 3 2 4 2823 S1,S3 
23 DOOOAMA READY 0 1 9 4 4 2809 A,S2 


REGULAR SPACE 

VOL# VOLNAME STATE EXP UNEXP TOTAL 
22 DOLOAMA READY 0 0 2 
23 DOOOAMA READY 0 0 4 


PARALLEL VOLUMES 

VOL# VOLNAME STATE IOC CARD VOL FSEG ROOM VLID CURR 
O DO40AMPO READY 4 1 1 N/A O 2813 YES 
2 DO20AMA2 READY 2 1 1 N/A O 2815 NO 


PARALLEL SPACE 

VOL# VOLNAME STATE SIZE (KB) PARALLEL_FILE 
O DO40AMPO READY 56230 B901208123022AMA 
2 DO20AMP2 READY 48789 B901206232008AMA 


Explanation: The requested information is displayed. 
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query (continued) 


Response 


The following table provides explanations of the responses to the query 
command. 


Response for the query command 


MAP output Meaning and action 


THIS SUBSYSTEM DOES NOT RECORD ON A DEVICE FOR WHICH 
THE SPACE OPTION IS SUPPORTED 


Meaning: The query space command string was entered when the specified 
subsystem was recording on tape. The space parameter is only valid for 
disk volumes. 


Action: None 


SSNAME SSNO SEONO ROTATES POOLNO PARLPOOL EMERGENCY 
AMA 0 1 2 0 36 FFEYESTHR 


FILES (S) STATE VOLUME RECOUNT BLOCK E V V_B VLID FNUM FRN# 
ACTIVE AVAIL DOOOAMAO ÉS 301 NO A006 0015 2058 
STANDBY1 AVAIL DO10AMAO 75 2 E 2 NO A004 0011 2034 


PARALLEL 
FILE STATE VOLUME BLOCK E V V_B VLID FILES 
B120812302201AMA AVAIL DO40AMPO 10V NO 2813 S1,S3 


REGULAR VOLUMES 

VOL# VOLNAME STATE IOC CARD VOL FSEG ROOM VLID FILES 
22 DOLOAMA READY 1 1 3 2 4 2823 S1,S3 
23 DOOOAMA READY 0 1 9 4 4 2809 A,S2 


REGULAR SPACE 

VOL# VOLNAM STATE EXP UNEXP TOTAL 
22 DOLOAMA READY 0 0 2 
23 DOOOAMA READY 0 0 4 


PARALLEL VOLUMES 

VOL# VOLNAME STATE IOC CARD VOL FSEG ROOM VLID CURR 
O DO40AMPO READY 4 1 1 N/A O 2813 YES 
2 DO20AMA2 READY 2 1 1 N/A 0 2815 NO 
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D-598 DIRP level commands 
query (continued) 


Response for the query command (continued) 


MAP output Meaning and action 


PARALLEL SPACE 
VOL# VOLNAME STATE SIZE (KB) PARALLEL_FILE 
O DO40AMPO READY 56230 B901208123022AMA 
2 DO20AMP2 READY 48789 B901206232008AMA<Response> 
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DIRP level commands D-599 
query (continued) 


Response for the query command (continued) 


MAP output Meaning and action 


Meaning: The system gives the response to the query command, with the desired 
information appearing beneath the following headings: 


ssname 
ssno 


seqno 


rotates 
poolno 


parlpool 


emergency 


regular file 


state 


volume 
reccount 
block 

e 

v 


v_b 


vlid 
fnum 
frn# 


parallel file 


subsystem name 
subsystem number as it appears in logs 


sequence number (0 indicates that the subsystem is 
not functioning) 


number of file rotates since last reload restart 
pool number index into table DIRPPOOL 


pool number in the table DIRPPOOL which the 
subsystem is using to store its parallel volumes 


marks the occurrence of an emergency rotate or 
reload (reset only by dirpauto or a manual audit) 


recording order status of active, standby number, 
parallel, or dead (file is being closed, label should 
clear within 30 seconds) 


availability status of available, reopening, none or 
missing, rewinding (for parallel only), or dead 


name of device file is on 

number of records on file 

number of 2-kilobyte (kb) blocks output 
input/output errors 

volume number in pool of table DIRPPOOL 


yes if blocks of less than 2-kb blocks can be output, 
no if fixed 2-kb blocks are output 


identification number of the disk drive or tape 
file number of the file on the volume 
file identification number 


file name of the parallel file on the parallel volume 


regular volume information on the regular volumes 
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D-600 DIRP level commands 
query (end) 


Response for the query command (continued) 


MAP output Meaning and action 


vol# volume number in the recording pool 
volname name of the device the recording volume is on 


state state the volume is in: 
- ready ready for recording 
- inerror removed from DIRP because of excessive faults 


- to be deleted removal from DIRP pending the availability of 
replacement volumes (another volume must be 
mounted before a volume in this state is 
removed from DIRP) 


IOC number 

physical card location 

volume number on the disk or tape 

number of DIRP_FILESEG files on the volume 


number of DIRP_FILESEGs currently available for 
immediate use, plus the number of 
DIRP_FILESEGs that can be created from expired 
P files 


files the recording order of A for active, S1-S3 for 
standby, and P for parallel 


regular space information on the regular space 
segs number of DIRP_FILESEG files on the volume 


exp number of DIRP_FILESEG files that could be 
created by deleting all expired process files 


unexp number of DIRP_FILESEG files that could be 
created by deleting all unexpired process files 


total total space available on the volume, which is the 
sum of the segs, exp, and unexp 


parallel volume information on the parallel volume 

parallel space ¡information on the parallel space 

size size in kb of the parallel file on the parallel volume 
Action: None 
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quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP 
level. 


This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. 
The system displays the next level higher than the one specified. Values for 
incrname are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current 
level. The range of retreat levels is 0-6. However, the system cannot accept 
a level number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DIRP level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DIRP level has changed to the previous menu level. 
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D-602 DIRP level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DIRP level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DIRP level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DIRP level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DIRP level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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revive 


Function 


Use the revive command to allow the DIRP child processes to be recreated 
after they have failed. The DIRP child processes are DIRPGI, DIRPDSON, 
and DIRPTSON. 


revive command parameters and variables 


Command Parameters and variables 


revive all 
dirpgi 
dirpdson 
dirptson 


Parameters 
and variables Description 


This default parameter directs the system to recreate all the DIRP child 
processes. 


This parameter directs the system to recreate the DIRPGI process. DIRPGI 
controls scheduled DIRP audits, DIRP alarms, and scheduled rotations of DIRP 
files. 


This parameter directs the system to recreate the DIRPDSON process. 
DIRPDSON maintains the disks as devices for DIRP. It runs the daily disk audit, 
responds to the audit command, executes the scheduled DIRP disk audit, and 
does audits of the disk in response to various events within DIRP. The events 
include mounting a new DIRP disk, demounting a disk volume, and opening and 
closing DIRP files. 


This parameter recreates the DIRPTSON process. DIRPTSON maintains the 
tapes as devices for DIRP. It is responsible for the scheduled DIRP tape audit 
and audits of tape in response to events in DIRP similar to those audits 
performed by DIRPDSON. 


Qualifications 


The revive command is qualified by the following exceptions, restrictions, 
and limitations: 


e The revive command should be the first approach to clearing the IOD 
DIRPGI or DIRP DEVB alarms. 


e Without the revive command, a warm restart is required to recreate the 
DIRPGI, DIRPDSON, or DIRPTSON processes. If the revive command 
1s unable to clear alarms, maintenance support personnel must perform a 
system restart. 
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D-606 DIRP level commands 
revive (continued) 


e The revive command does not correct the problem that caused the failure 
of the child processes. 


e Use of the revive command when a process has failed does not affect the 
process in any way other than the attempt to bring it back to life. 


Example 
The following table provides an example of the revive command. 


Example of the revive command 


Example Task, response, and explanation 


revive dipgi — 
Task: Revive the DIRPGI process. 


Response: Revive DIRPGI? 
Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before attempting the revive. 


Responses 


The following table provides explanations of the responses to the revive 
command. 


Responses for the revive command 
MAP output Meaning and action 
Attempting to revive DIRPGI 
Meaning: The system has allocated resources. The process is being revived. 


Action: None 


Could not allocate mailbox to revive DIRPGI 
Try again later 


Meaning: The system could not allocate resources to perform the revival of this 
process. 


Action: Attempt the revive command again later. Contact maintenance support 
personnel if the revive command continues to generate this message. 
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revive (continued) 


Responses for the revive command (continued) 


MAP output Meaning and action 


Could not dealloc reply mailbox, 
Return code: <rc value> 
After attempt to revive DIRPGI 


Meaning: A software problem has prevented the revive command from 
deallocating resources associated with the revival ofthe process. The 
<rc value> is replaced with a code that identifies the problem. 


Contact maintenance support personnel. 


Could not send to daddy, Return code <rc value> 
DIRPGI not revived 


Meaning: A software problem has prevented the revive command from reviving the 
process. The <rc value> is replaced with a code that identifies the 
problem. 


Action: Contact maintenance support personnel. 


DIRPI is not a DIRP child process 
Valid DIRP child processes are: 
DIRPGI 
DIRPDSON 
DIRPTSON 
Request aborted 


Meaning: You entered an invalid process name. 


Action: Enter the command again with the proper process name. 


DIRPDSON not revived, already running 
Meaning: The process is running and does not need to be revived. 


Action: None 


DIRPDSON not revived, attempt failed 
See DIRP logs for details 


Meaning: The revival failed. 


Action: Review the logs for the reason of the failure. 
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revive (continued) 


Responses for the revive command (continued) 
MAP output Meaning and action 
DIRPTSON not revived, does not exist 


Meaning: The software and tables that support the revive command may be 
corrupted. 


Action: Contact maintenance support personnel. 
DIRPTSON successfully revived 
Meaning: The process has been revived successfully. 


Action: None 


No DIRP child processes are dead. 
Request aborted 


Meaning: No processes are dead. 


Action: None 


No reply from daddy process for DIRPGI 
See DIRP logs 


Meaning: The results of the revival were not known by the end of the one minute 
revival period. When the revival is completed, a DIRP101 log reports 
the result of the revival. 

Action: Check the log reports for DIRP101 logs with the results of the revival. 


Problem waiting for reply, return code: <rc value> 
Logs may contain details of attempt to revive DIRPGI 


Meaning: Software problems prevented the revive command from receiving the 
results of the revival attempt. The revival attempt my still succeed. The 
<rc value> is replaced with a code that identifies the software problem. 


Check DIRP101 logs for revival results. Contact maintenance support 
personnel. 


Revive DIRPGI? 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before starting the revival. 


Action: Enter yes to continue the revive. Enter no to abort the command. 
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revive (end) 


Responses for the revive command (continued) 


MAP output Meaning and action 


Revive all DIRP child processes? 
Please confirm (“YES” or “NO”) 


Meaning: The system prompts for confirmation before starting the revival. 
Action: Enter yes to continue the revive. Enter no to abort the command. 
Request aborted 


Meaning: You entered the wrong process, or you entered a no to a prompt for 
confirmation. 


Action: Enter the revive command with the correct process name if appropriate. 


Unrecognized procstate returned from 
DIRPGI revive 

Reply returned: <value> 

DIRP logs may contain details of revive 


Meaning: The result of the attempt could not be determined. Supporting revive 
command software and tables may be corrupted. The <value> is 
replaced by an integer which is the procstate value. 


Action: Contact maintenance support personnel. 


WARNING: DIRPGI is dead and must be revived to restore DIRP completely. 
Meaning: A process other than the one being revived is dead. 


Action: Revive the other dead process. 
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rotate 


Function 


Use the rotate command to initiate manual rotation of duties for the 
recording files of the specified subsystem. If the rotaclos field in table 
DIRPSSYS is set to mrotate or to both, the rotate command also closes the 
active file. 


rotate command parameters and variables 
Command Parameters and variables 
rotate subsystem regular 


parallel 
both 


Parameters 
and variables Description 


This parameter directs the system to rotate both regular and parallel files. 


This parameter directs the system to rotate parallel files. 
This default parameter directs the system to rotate regular files. 


This variable is the subsystem name. 


Qualifications 
The rotate command is qualified by the following exceptions, restrictions, 
and limitations: 


e When the rotaclos field in table DIRPSSYS is set to mrotate or to both, 
the rotate command also closes the active file. File security is not 
compromised. 


e The subsystem name used with the rotate command must be the name of 
a subsystem identified in table DIRPSSYS. 


e The rotate command has an effect only if more than one file is open for 
the specified subsystem. 
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D-612 DIRP level commands 
rotate (continued) 


Example 
The following table provides an example of the rotate command. 


Example of the rotate command 


Example Task, response, and explanation 


rotate ama — 
where 


ama is the subsystem on which the files are to be rotated 


Task: Rotate the recording files of the AMA subsystem. 


Response: ACTIVE FILE WILL BE CLOSED IF POSSIBLE 
(ROTACLOS) . 
SENDING REQUEST TO SUBSYSTEM 
Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before performing the 
rotation. 


Responses 
The following table provides explanations of the responses to the rotate 


command. 


Responses for the rotate command 


MAP output Meaning and action 


ACTIVE FILE WILL BE CLOSED IF POSSIBLE (ROTACLOS). 
SENDING REQUEST TO SUBSYSTEM 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before performing the rotation. 


Action: Enter yes to continue with the rotate command. Enter no to abort the 
command. 


ERROR-multiple parallel volume feature not present. 


Meaning: This office is not capable of supporting multiple volumes in parallel 
pools. 


Action: None 
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rotate (continued) 


Responses for the rotate command (continued) 
MAP output Meaning and action 
ERROR-Parallel rotate not completed, check logs. 
Meaning: The system detected an error during the parallel rotate. 


Action: Check the logs to determine why rotate failed. 


Insufficient files to do rotate. 
Meaning: There are no other files to rotate into the active position. 


Action: Mount additional volumes, then try the rotate command again. 


No synchronized rotate possible 
NUMFILES = 1 
Issue separate manual/parallel rotate requests 


Meaning: The rotate command was entered with the both parameter while the 
DIRPSSYS parameter numfiles for the subsystem was set to 1. In this 
nonstandard field datafill, the system will not attempt a rotate. 


Action: Enter separate commands to rotate both the regular and parallel files. 
Request sent to subsystem, check DIRP log for details. 
Meaning: The rotate command was successfully completed. 


Action: None 


SENDING REQUEST TO SUBSYSTEM 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before performing the rotation. 


Action: Enter yes to continue with the rotate command. Enter no to abort the 
command. 
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rotate (end) 


Responses for the rotate command (continued) 


MAP output Meaning and action 


SUBSYSTEM HAS NOT REPLIED WITHIN 30 SEC LIMIT. 
WATCH DIRP LOGS FOR RESULTS. 
IF NONE FOUND, TRY AGAIN LATER. 


Meaning: The subsystem did not respond within the timeout limit. The files may 
not have been rotated. 


Action: Check the DIRP logs. Repeat the command if there is no confirmation 
of the rotate in the logs within a reasonable amount of time. Contact 
maintenance support personnel if this response occurs repeatedly. 


WARNING-Manual parallel rotations reduce the total 
amount of parallel data retention on the switch. 
SENDING REQUEST TO SUBSYSTEM 

Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation before performing the rotation. 
Parallel rotates decrease the total retention period of parallel data. The 
manual rotate defeats the purpose of automatic parallel rotations which 
occur after the entire file has been used to record fresh subsystem data. 


Enter yes to continue with the rotate command. Enter no to abort the 
command. 


WARNING-Rotation may not have been synchronized. 
Check logs. 


Meaning: You attempted to rotate both regular and parallel files, but due to an 
unexpected condition, the rotation was not synchronized. Both sets of 
files were rotated, but it is possible that extra subsystem transfer records 
exist on the beginning of the new currently recording parallel file. 


Check the logs to determine exactly when the regular and parallel files 
rotated in relation to one another. 
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rsetvol 


Function 


Use the rsetvol command to reset the state of a volume to indicate to DIRP 
that the specified volume is now available for recording. 


rsetvol command parameters and variables 
Command Parameters and variables 


rsetvol pool_no volume_no 
volume_name 


Parameters 
and variables Description 


pool_no This variable specifies the number of the pool, from table DIRPPOOL, that 
contains the volume to be reset. 


volume_name This variable specifies the volume by volume name. 


volume_no This variable specifies the volume number of the volume to be reset. Valid 
entries are 0-23. 


Qualifications 


The rsetvol command is qualified by the following exceptions, restrictions, 
and limitations: 


e This command can be used when a volume has been marked in a 
DIRP101 log as having an error, and a subsequent manual check has 
shown that the error condition did not affect the recording volume. It 
can also be used when a volume as faulty, as indicated by a minor alarm 
on the MAP display or a fault response to the query command. 


e When a disk volume becomes full and recording space is required, 
unnecessary files can be erased manually. The rsetvol command is then 
entered to restore the volume to use. 


e This command can also query the present state of the volume. If the 
specified volume is not marked as being in error, the system responds by 
indicating the state. 
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rsetvol (continued) 


Example 
The following table provides an example of the rsetvol command. 


Example of the rsetvol command 


Example Task, response, and explanation 


rsetvol d000ama — 
where 


d000ama is the name of the volume to be reset 


Task: Reset the specified volume. 


Response: Marking volume as ’ Ready’ 
Please confirm (“YES” or “NO”): 


Explanation: The system prompts for confirmation before resetting the volume. 


Responses 
The following table provides explanations of the responses to the rsetvol 


command. 


Responses for the rsetvol command 


MAP output Meaning and action 
Done-Auditing affected volume/sub-system(s) 
Meaning: The rsetvol command was successfully completed. 


Action: None 


File system errors have occurred on this volume which 
may affect its ability to record data reliably. 

The cause of these errors should be investigated 

and all problems should be resolved before resetting 
this volume 


Please confirm (“YES” or “NO”): 


Meaning: 


Action: None 
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rsetvol (continued) 


Responses for the rsetvol command (continued) 


MAP output Meaning and action 


Marking volume as ’Ready’ 
Please confirm (“YES” or “NO”): 


Meaning: The system prompts for confirmation. 


Action: Enter yes to continue resetting the volume. Enter no to abort the 
command. 


Parallel AMA volume will be marked as ‘Ready’, 
DOOOAMPO: Volume O in Parallel Pool 32, AMAPARL 


DONE-Auditing affected volume/subsystem(s). 
Meaning: The rsetvol command was completed successfully. 
Action: None 

Parameter not pool/vol numbers or volume name string 


Meaning: A parameter entered with the rsetvol command is not recognized by the 
system as the pool and volume numbers or the volume name. 


Action: Retry the command with valid parameters. 
Pool number must be between 0 and 31 
Meaning: The value entered as the poo/_no parameter was invalid. 


Action: Check the value entered and retry the rsetvol command. 


Volume number must be entered along with pool number 


Meaning: The command was entered with only one numeric parameter. If the pool 
number or the volume number is entered, the other must also be 
entered. 


Action: Enter the rsetvol command with valid parameters. 


Volume state is in-service and can’t be changed 


Meaning: The command was attempted on a volume that was not in the in-error 
state. The response gives the current volume state. 


Action: None 
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rsetvol (end) 


Responses for the rsetvol command (continued) 


MAP output Meaning and action 


Volume state is in-service and the volume is low on space 


Meaning: The command was attempted on a volume that was not in the in-error 


state and the volume has less than four DIRP fileseg files. The current 
volume state is given in the response. 


Action: None 
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D-619 


DISPLAY level commands 


Use the DISPLAY level of the MAP to monitor and maintain the trunks that 
are associated with carriers. 


Accessing the DISPLAY level 
To access the DISPLAY level, enter the following from the CI level: 
mapci;mtc;trks;carrier;display — 
DISPLAY commands 


The commands available at the DISPLAY MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DISPLAY commands 


Command 
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D-620 DISPLAY level commands 


DISPLAY menu 
The following figure shows the DISPLAY menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 


CARRIER CLASS ML OS ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 


0 Quit TRUNKS 0 0 8 8 2 0 0 0 0 5 
2 Post_ REMOTE 0 0 0 0 0 0 0 0 0 4 
3 TIMING 0 0 0 0 0 0 0 0 0 0 
4 
5 
6 
E 
8 
9 

10 

11 Disp_ 

12 Next 

13 

14 

15 

16 

1} 

18 

DISPLAY status codes 
The following table describes the status codes for the DISPLAY status 
display. 


Status codes DISPLAY menu status display 
ALARM 
CBSY 


INSV 
MANB 
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Status codes DISPLAY menu status display (continued) 


Description 


ML 
OFFL 
OS 
PBSY 


REMOTE 

SYSB 

TIMING 

TRUNKS 

UNEQ 

Co e 
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disp 


Function 
Use the disp command to list all carriers of a specified state. 


disp command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter displays the carriers with alarms. 
This parameter displays the C-side busy carriers. 
This parameter displays the in-service carriers. 
This parameter displays the manually busy carriers. 
This parameter displays the maintenance limit. 
This parameter displays the offline carriers. 


This parameter displays the out-of-service carriers. 


This parameter displays the P-side busy carriers. 


This parameter displays the system busy carriers. 


This parameter displays the unequipped carriers. 


Qualifications 
None 
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D-624 DISPLAY level commands 
disp (continued) 


Examples 
The following table provides an example of the disp command. 


Examples of the disp command 


Example Task, response, and explanation 


disp manb u 
Task: Display the carriers in the manb state. 


Response: See the response table within this section for the complete 
response. 


Explanation: The command string disp manb has been entered and the number 
of carriers in the specified state is displayed. 


Responses 


The following table provides explanations of the responses to the disp 
command. 


Responses for the disp command 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 6 0 0 0 0 34 
REMOTE 0 7 4 0 0 0 0 10 87 
TIMING 2 2 0 0 0 0 0 0 2 
PROTLN 0 3 0 0 0 0 0 2 


disp cbsy 
Empty set 


Meaning: The command string disp cbsy has been entered, but there are no 
carriers in the specified state. 


Action: None 
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disp (continued) 


Responses for the disp command (continued) 


MAP output 


CLASS ML 
TRUNKS 9 
REMOTE 0 
TIMING 2 
PROTLN 0 


disp offl 
Empty set 


CLASS ML 
TRUNKS 9 
REMOTE 0 
TIMING 2 
PROTLN 0 


disp os 
Empty set 


CLASS ML 
TRUNKS 9 
REMOTE O0 
TIMING 2 
PROTLN 0 


disp uneq 
Empty set 


Meaning and action 


ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
59 46 6 0 0 0 0 34 

yl 4 0 0 0 0 10 87 

2 0 0 0 0 0 0 2 

3 0 0 0 0 0 2 


Meaning: The command string disp offl has been entered, but there are no carriers 
in the specified state. 


Action: None 
ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
59 46 6 0 0 0 0 34 
7 4 0 0 0 0 10 87 
2 0 0 0 0 0 0 2 
3 0 0 0 0 0 2 


Meaning: The command string disp os has been entered, but there are no carriers 
in the specified state. 


Action: None 
ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
59 46 6 0 0 0 0 34 
7 4 0 0 0 0 10 87 
2 0 0 0 0 0 0 2 
3 0 0 0 0 0 2 


Meaning: The command string disp uneq has been entered, but there are no 
carriers in the specified state. 


Action: None 
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disp (continued) 


Responses for the disp command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 0 0 0 0 34 
REMOTE 0 0 0 10 87 
TIMING 0 0 0 0 2 
PROTLN 0 0 0 2 


NO 
0 


LTC 

RCCI 
SMSR 
MORE... 


0 
0 
0 
0 
2 
0 
3 
0 
0 


At this point, pressing the enter key will cause more alarm data to appear in the MAP display: 


SR SR 16 SMSR MSR 
SR SR SMSR ISR 
SR SR SMSR ISR 
SR SR SMSR ISR 
SR SR SMSR SR 
SR 13 SR SMSR SR 
S 


SR 17 SR SR SR 


DISPLAYED BY CONDITION : ALARM 


Meaning: The command string disp alarm has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 
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disp (continued) 


Responses for the disp command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 0 0 0 0 34 
REMOTE 0 7 4 0 0 0 10 87 
TIMING 2 0 0 0 0 0 2 
PROTLN 0 0 0 0 


PM NO CKT PM NO CKT 
DCM 0 0 DCM 1 0 
DTC 0 5 DTC 0 9 
RCCI 0 5 RCCI 1 5 


DISPLAYED BY CONDITION : ML 


Meaning: The command string disp ml has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 


CLASS ML ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 6 0 0 0 0 34 
REMOTE 0 4 0 0 0 0 10 87 
TIMING 2 0 0 0 0 0 2 
PROTLN 0 0 0 0 0 0 2 


PM NO CKT PM NO CKT PM NO CKT PM NO CKT 
LTC 2 10 LTC 2 11 LTC 3 8 LTC 3 9 
LTC 4 18 LTC 4 19 


DISPLAYED BY CONDITION : MANB 


Meaning: The command string disp manb has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 
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disp (continued) 


Responses for the disp command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 5 23 20 0 2 2 5 0 ZT 
REMOTE 12 17 2 0 0 0 7 3 16 
TIMING 1 1 0 0 0 0 1 0 1 


PM NO CKT PM NO CKT PM NO CKT PM NO CKT 
TMS 1 7 TMS 1 9 


DISPLAYED BY CONDITION : OFFL 


Meaning: The command string disp offl has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 6 0 0 0 0 34 
REMOTE 0 4 0 0 0 0 10 87 
TIMING 2 0 0 0 0 0 2 
PROTLN 0 0 0 0 0 0 2 


PM NO CKT PM NO CKT PM NO CKT 
RCC2 0 24 RCC2 0 25 RCC2 0 27 
RCC2 0 28 RCC2 0 29 SMSR 1 14 
SMSR 2 0 SMSR 2 2 SMSR 2 6 


DISPLAYED BY CONDITION : PBSY 


Meaning: The command string disp pbsy has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 
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DISPLAY level commands D-629 
disp (end) 


Responses for the disp command (continued) 


MAP output Meaning and action 


CLASS ML O ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 
TRUNKS 9 59 46 6 0 0 0 0 34 
REMOTE 0 7 4 0 0 0 0 10 87 
TIMING 2 0 0 0 0 0 2 
PROTLN 0 3 0 0 0 0 0 2 


DISPLAYED BY CONDITION : SYSB 


Meaning: The command string disp sysb has been entered and the number of 
carriers in the specified state is displayed. 


Action: None 
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DISPLAY level commands D-631 
next 


Function 


Use the next command to display information on the next carriers in the 
posted set. 


next command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


Not currently available 
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DISPLAY level commands D-633 
post 


Function 


Use the post command to select specified carriers for maintenance action 
and display information for up to five carriers. 


post command parameters and variables 


Command Parameters and variables 


trunks 
remote 
timing 
protline 
dsOlnk 
ds1 
d30 
m20 
ttc 
sonet 
ndsO 
cbsy 
pbsy 
insv 
manb 
sysb 
uneq 
offl 
alarm 
os 

ml 

ec 
pm_type pm_no carrier 


pcm_type 


Parameters 
and variables Description 


This parameter displays information on carriers in alarm conditions. 


This parameter posts remote cluster controller (RCC) C-side carriers. 


This variable, ranging from 0-19, specifies the carrier number. 
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D-634 DISPLAY level commands 
post (continued) 


post command parameters and variables (continued) 


Parameters 
and variables 


Description 


This parameter displays carriers in the C-side busy state. 


This parameter displays information about DMS-100 circuits using the PCM-30 
format (D30). 


This parameter displays (Not currently available). 

This parameter displays (Not currently available). 

This parameter displays (Not currently available). 

This parameter displays carriers in the in-service state. 

This parameter displays (Not currently available). 

This parameter displays carriers in the manual busy state. 

This parameter displays carriers which exceed the maintenance limit. 
This parameter displays on NDSO carriers. 

This parameter displays carriers in the offline state. 

This parameter displays carriers which exceed the out-of-service limit. 
This parameter displays carriers in the P-side busy state. 


This variable specified the type of pulse code modulation (PCM) used by the carrigr 
and is specified where multiple PCM types are datafilled on the same peripheral 
module (PM). The types of pulse code modulation are: 


D30 
DSO 
DS1 
M20 


This variable, ranging from 0-511, specifies the discrimination number of the PM. 


297-1001-821 Standard 04.01 June 1999 


DISPLAY level commands D-635 
post (continued) 


post command parameters and variables (continued) 


Parameters 
and variables Description 


This variable specifies one of the following PM types: 
adct-Not currently available 
algc-Not currently available 
arcc-Not currently available 
dca-Not currently available 
dcm-digital carrier module 
dct-Not currently available 
dfi-direct fiber interface 
dtc-digital trunk controller 
dtci-Integrated Services Digital Network (ISDN) digital trunk controller 
hsi2-Not currently available 
iac-ISDN access controller 
icp-Not currently available 
idtc-international digital trunk controller 
ilgc-international line group controller 
iltc-international line trunk controller 
itac-Not currently available 
Igc-line group controller 
pdtc-digital trunk controller for PCM-30 
plgc-line group controller for PCM-30 


prcc-Not currently available 


rcc-remote cluster controller 
rcc2-remote cluster controller 2 


rcci-ISDN remote cluster controller 
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D-636 DISPLAY level commands 
post (continued) 


post command parameters and variables (continued) 


Parameters 
and variables Description 


rco2-Not currently available 
rmsc-Not currently available 
sma-Not currently available 
smr-subscriber module remote 
sms-subscriber module SCM-100 
smsr-subscriber module remote 
smu-subscriber module urban 
srcc-Not currently available 
tac-Not currently available 
tdtc-Not currently available 
tlgc-Not currently available 
tltc-Not currently available 
tms-TOPS message switch 


trcc-Not currently available 
This parameter displays information on protection lines. 
This parameter displays information about the remote end of the carrier. 


This parameter displays information on the remote end of the carrier. 


This parameter displays information about the Synchronous Optical Network 
(SONET). 


This parameter displays carriers in the system busy state. 
This parameter displays information on timing links. 
This parameter displays information on trunks for the specified PM. 


This parameter displays carrier-trunk information. 
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DISPLAY level commands D-637 
post (continued) 


post command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter displays information about trunk test centers (TTC). 


This parameter displays carriers in the unequipped state. 


Qualifications 


The post command is qualified by the following exceptions, restrictions, and 
limitations: 


e For PMs which do not support ES or SES, the data field displays a 0 
(zero). 


e The display format depends on both the type of carriers being posted and 
on the condition selected. 


e Generic classification of a carrier (trunks, remote, timing, protline) 
appears below the header STATE. 


e When an SMS is posted at the CARRIER level, the command protsw is 
added to the menu. 


e Tf all carriers on the PM are posted using the command string post plge 
0, the posted sets are displayed in groups by PCM type, the number of 
sets equal to the number of different PCM types datafilled on the PM. 
Use the next command to display the other PCM types. 


Example 
The following table provides an example of the post command. 


Example of the post command 
Example Task, response, and explanation 


post alarm — 


Task: Enter the command string post alarm and display the posted 
carriers in the specified state. 


Response: See the response table within this section for the complete 
response. 


Explanation: The command string post alarm has been entered and the posted 
carriers in the specified state are displayed. 
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D-638 DISPLAY level commands 
post (continued) 


Responses 


The following table provides explanations of the responses to the post 
command. 


Responses for the post command 


MAP output Meaning and action 


N CLASS SITE pm CKT D ALRM SLIP FRME BER ES SES 


Meaning: The system displays information for the set of posted carriers, where: 


is one of the trunk alarms 
is the bit error ratio (ber) 


is the circuit number on the PM to which the carrier 
is connected 


is one of the following: protin, remote, timing, trunks 


specifies the direction of the posted carrier, either 
C-side or P-side 


is the quantity of error seconds 


is the quantity of times the carrier has exceeded the 
24-hour threshold for framing errors 


is the number of the carrier 
is the type of PM to which the carrier is connected 
is the quantity of severe error seconds 


host, which indicates a local carrier connected to the 
host, or rem, which indicates a remote carrier 
connected to a PM 


SLIP is the quantity of times the carrier has exceeded the 
24-hour threshold for slipping errors 


STATE is one of the states listed in the CARRIER level 
status codes table at the beginning of this section 


Action: None 
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DISPLAY level commands D-639 
post (continued) 


Responses for the post command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 5 22 19 0 2 0 5 0 28 
REMOTE 14 19 4 0 0 0 7 

TIMING 1 1 0 0 0 0 

DS1 

N CLASS SITE DCM CK D ALRM SLIP 

O TIMING HOST 0 0 Cc SLIP MI 
1 TRUNKS HOST C SLIP 

2 TRUNKS HOST C SLIP 


POSTED BY CONDITION : ALARM 


Meaning: The command string post alarm has been entered and the posted 
carriers in the specified state are displayed 


Action: None 


CLASS ML ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 
TRUNKS 5 19 0 2 0 5 0 28 
REMOTE 14 4 0 0 0 7 3 16 
TIMING 1 0 0 0 0 1 0 1 
DS1 

N CLASS SITE DCM CK D ALRM SLIP FRME 

TIMING HOST 
TRUNKS HOST 
TRUNKS HOST 
TRUNKS HOST 
TRUNKS HOST 


POSTED BY CONDITION 


Meaning: The command string post cbsy has been entered and the posted carriers 
in the specified state are displayed. 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-640 DISPLAY level commands 
post (continued) 


Responses for the post command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 

TRUNKS 5 22 19 0 2 0 5 0 28 

REMOTE 14 19 4 0 0 0 7 3 16 

TIMING 1 0 0 0 1 0 1 

DS1 

NO CLASS ALARM SLIP STATE TLINK MODE 

O TIMING DCM SLIP ML INSV O <condition> 
1 TRUNKS DCM 3 0 CBSY 1 <condition> 


POSTED BY CONDITION : <condition> 


Meaning: The command string post <condition>, where <condition> represents a 
specified condition, has been entered, but there are no carriers in the 
specified state. 


Action: None 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 

TRUNKS 5 19 0 2 0 5 0 28 

REMOTE 12 4 0 0 0 7 3 16 

TIMING 1 0 0 0 0 1 0 1 

DS1 

N CLASS SITE DCM CK D ALRM SLIP SES 

TIMING HOST C SLIP ML 

TRUNKS HOST C 

TRUNKS HOST C 
Cc 
C 


TRUNKS HOST 
TRUNKS HOST 


POSTED BY CONDITION 


Meaning: The command string post ds1 has been entered and the number of 
posted carriers in the specified state is displayed. 


Action: None 
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DISPLAY level commands D-641 
post (continued) 


Responses for the post command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 
TRUNKS 5 19 0 2 0 5 0 28 
REMOTE 12 4 0 0 0 7 

TIMING 1 0 0 0 0 

DS1 

N CLASS SITE DCM CK D ALRM SLIP 

O TIMING HOST 0 C SLIP MI 
1 TRUNKS HOST 1 C SLIP 

2 TRUNKS HOST 2 C SLIP 


POSTED BY CONDITION 


Meaning: The command string post ml has been entered and the number of 
posted carriers in the specified state is displayed. 


Action: None 


CLASS ML ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 

TRUNKS 5 22 19 0 2 0 5 0 28 

REMOTE 14 19 4 0 0 0 7 3 16 

TIMING 1 0 0 0 1 0 1 

DS1 

NO CLASS ALARM SLIP STATE TLINK MODE 
0 TIMING DCM SLIP ML INSV 0 STANDBY 
1 TRUNKS DCM 3 0 CBSY 1 STANDBY 


POSTED BY CONDITION : TIMING 


Meaning: The command string post timing has been entered and the number of 
posted carriers in the specified state is displayed. 


Action: None 
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D-642 DISPLAY level commands 
post (end) 


Responses for the post command (continued) 


MAP output Meaning and action 


CLASS ML ALARM SYSB MANB UNEO OFFL CBSY PBSY INSV 

TRUNKS 5 19 0 2 0 5 0 28 

REMOTE 12 4 0 0 0 7 3 16 

TIMING 1 0 0 0 0 1 0 1 

DS1 

N CLASS SITE DCM CK D ALRM SLIP FRME BER E SES 

TIMING HOST C SLIP ML 

TRUNKS HOST € 

TRUNKS HOST C 
Cc 
C 


TRUNKS HOST 
TRUNKS HOST 


POSTED BY CONDITION : TRUNKS 


Meaning: The command string post trunks has been entered and the number of 
posted carriers in the specified state is displayed. 


Action: None 


CLASS ML ALARM SYSB MANB UNEQ OFFL CBSY PBSY INSV 
TRUNKS 5 22 19 0 2 0 5 0 28 
REMOTE 12 0 0 0 7 3 16 
TIMING 1 0 0 0 1 0 1 

DS1 

NO CLASS ALRM SLIP FRME BER ES SES 
O TIMING 0 0 0.0 0 

1 TRUNKS 0 0 0.0 0 


POSTED BY CONDITION : UNEO 


Meaning: The command string post uneq has been entered and the number of 
posted carriers in the specified state is displayed. 


Action: None 
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DISPLAY level commands D-643 
quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mapci, or mtc. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DISPLAY level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DISPLAY level has changed to the previous menu level. 
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D-644 DISPLAY level commands 
quit (continued) 


Examples of the quit command (continued) 
Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DISPLAY level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DISPLAY level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the display of the DISPLAY level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DISPLAY level commands D-645 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the DISPLAY level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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D-647 


DLC level commands 


Use the data link controller (DLC) level of the MAP to test and change the 
status of the DLC. 


Accessing the DLC level 
To access the DLC level, enter the following from the CI (command 
interpreter) level: 
mapci;mtc;iod;ioc O;card 3 J 
In this example, 0 is the input/output controller (IOC) on which card 3 is 
attached to a DLC. 


DLC commands 
The commands available at the DLC MAP level are described in this chapter 
and arranged in alphabetical order. The page number for each command is 
listed in the following table. 


DLC commands 


Command 


listdev 
locate 


offl 


qnode 


quit 
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D-648 DLC level commands 


DLC menu 


The following figure shows the DLC menu and status display. The insert 
with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
DLC TOD TOC 0 1 2 3 4 
0 Quit Stat 
2 
3 DIRP $ XFER 
4 ListDev_ 
5 IOC Card 0 1 2 3 4 5 
6 Tst 1 Port 0123 0123 0123 0123 0123 0123 
7 Bsy Stat == 4:99 .--- SSSS P--= SSSS 
8 RTS Type MTD Cons DDU Cons DDU Cons 
9 Offl 
10 Card 4 Unit 1 
11 User SYSTEM Drive_State 
12 QNODE Status SBsy drive_faults 
13 LOCATE 
14 
15 
16 
17 
18 


DLC status codes 
The following table describes the status codes for the DLC status display. 


Status codes DLC menu status display (continued) 
Code Meaning Description 

System 
InSv in service The DLC is in-service. 
Offl offline The DLC is offline. 


MBsy manually The DLC has been placed in the manually-busy state. 
busy 


SBsy system The DLC is in the system-busy state. 
busy 


unequipped The DLC is not equipped. 
An error has occurred during a system procedure. 
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D-649 DLC level commands 
listdev 


Function 


Use the listdev command to display the status of a specified device that is 
connected to a specified data link controller (DLC). 


listdev command parameters and variables 
Command Parameters and variables 
listdev device_type 


Parameters 
and variables Description 


device_type This variable is the device type. Valid entries are nx25, dic, cons, dpac, mtd, ddu, 
and mpc. 


dic This parameter directs the system to list allthe DLCs. 


loc This variable identifies the number of a specific input/output controller (IOC) card. 
Valid entries are 0-19. 


Qualifications 


The listdev command is qualified by the following exceptions, restrictions, 
and limitations: 


e The display is limited to only those devices of the specified type attached 


to the specified IOC. 


e When more than one device is connected to the same card, the command 
listdev displays only the information for the device on port zero. 
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D-650 DLC level commands 
listdev (continued) 


Examples 
The following table provides an example of the listdev command. 


Examples of the listdev command 


Example Task, response, and explanation 


listdev 1 dic J 
where 


1 is the number of the IOC card connected to the devices 


Task: Listthe DLCs. 


Response: DLC USER STATUS IOC CARD PORT 
0 NONE SBsy 0 1 0 


Explanation: The response lists all the DLCs and provides identification and 
status information about each one. 


Responses 
The following table describes the meaning and significance of each portion 


of the full response to the listdev command, and examples of full responses. 


Responses for the listdev command 


MAP output Meaning and action 


DLC USER STATUS IOC CARD PORT 
0 NONE SBsy 0 1 0 


Meaning: This is an example of a display in response to the listdev command with 
dic specified as the device. 


Action: None 


Meaning: Identifies the card position within the IOC occupied by the DLC. 


Action: None 
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DLC level commands D-651 
listdev (continued) 


Responses for the listdev command (continued) 


MAP output Meaning and action 


Meaning: 


Action: 


INVALID 
Card unknown 


Meaning: 


Action: 


Meaning: 


Action: 


Meaning: 
Action: 


STATUS 
OFFL 


Meaning: 


Action: 


This column echoes the device specified, and provides the number of 
each device. 


None 


A listdev display cannot occur. Possible reasons for the command to be 
invalid are because the card is unknown, the card is of an unknown type, 
or no device exists for the device specified. 


None 


Identifies the IOC number to which the DLC is connected. 


None 


Identifies the port on the card to which the DLC connection is configured. 


None 


Provides the status of the device. 


None 
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D-652 DLC level commands 
listdev (end) 


Responses for the listdev command (continued) 


MAP output Meaning and action 


Meaning: Displays the field value specific to the relevant device. DLC displays 
none. 


Action: None 
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DLC level commands D-653 
locate 


Function 


Use the locate command to obtain the location codes for the identification 
scheme of cards which connect to the peripheral modules. 


locate command parameters and variables 


Command Parameters and variables 


locate There are no parameters or variables. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


The following table provides an explanation of the response to the locate 
command. 


Responses for the locate command 


MAP output Meaning and action 


SITE FLD RPOS BAY_ID SHF DESCRIPTION SLOT EQPEC 


Meaning: The system displays the requested information under these display 
headers. The headers correpsond to the DMS card identification 
scheme. 


Action: None 
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DLC level commands D-655 
offl 


Function 
Use the offl command to change the status of the displayed DLC disk 
controller card to offline. 


offl command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
The offl command is qualified by the following exceptions, restrictions and 


limitations: 

e Before entering the offl command, the DLC status must be manually 
busy. 

+ When one port of a DLC card is made offline, the whole card is made 
offline. 


e Cards that are offline must be made manually busy again before entering 
the rts command. 


Example 
The following table provides an example of the offl command. 


Example of the offl command 


Example Task, response, and explanation 


Task: Take the displayed DLC offline. 


Response: OK 


Explanation: The MTD is offline. 
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D-656 DLC level commands 
offl (end) 


Responses 


The following table provides the common responses to the offl command. 


Responses for the offl command 


MAP output Meaning and action 


Meaning: The system takes DLC card offline. 


Action: None 


REQUEST INVALID 
DEVICE DLC 1 IS IN SERVICE 


Meaning: The DLC card cannot be made offline while it is being used for a call 
process. The response displays the DLC discrimination number. 


Action: None 
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DLC level commands D-657 
anode 


Function 


Use the qnode command to query and display data about the DLC node by 
which the device is connected. 


qnode command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Example 
The following table provides an example of the qnode command. 


Example of the qnode command 


Example Task, response, and explanation 


Task: Obtain the status of the DLC node by which the displayed DLC is 
connected. 


Response: DLC 1 
IS IN-SERVICE 


Explanation: The DLC displayed is DLC 1, and its status is in-service. 


Response 


The following table provides an explanation of the response to the qnode 
command. 


Response for the qnode command 


MAP output Meaning and action 


DLC 0 
is offline 


Meaning: The status of the DLC will be one of the following: is in-service, is offline, 
is man busy, is system busy, is unequipped. 


Action: None 
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DLC level commands D-659 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DLC level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DLC level has changed to the previous menu level. 
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D-660 DLC level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DLC level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DLC level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DLC level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DLC level commands D-661 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display ofthe DLC level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DLC level commands D-663 
rts 


Function 
Use the rts command to test and return the DLC card to service. 


rts command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
The rts command is qualified by the following restrictions: 


e The DLC must be either manually busied or system busy before the rts 
command can be implemented. 


e Tests are invoked before the return to service which is executed only 
when the tests pass. 


Example 
The following table provides one example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


Task: Return the displayed DLC card to service. 


Response: REQUEST PASSED 


Explanation: The DLC is active and in service. 
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D-664 DLC level commands 
rts (end) 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 
MAP output Meaning and action 


REQUEST FAILED 


Meaning: The card cannot be returned to service. 


Action: Check the circuit status. If appropriate, replace the card. 


REQUEST PASSED 
Meaning: The DLC is active and in service. 


Action: None 
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DLC level commands D-665 
tst 


Function 
Use the tst command to invoke read-only memory (ROM) tests for the DLC 
card. 


tst command parameters and variables 


Command Parameters and variables 


There are no parameters and variables. 


Qualification 
The tst command is qualified by the following restriction: the card status 
must be manually busy or system busy before you enter the tst command. 


Examples 
The following table provides an example of the tst command. 


Examples of the tst command 


Example Task, response, and explanation 


Task: Test the displayed DLC card. 


Response: REQUEST PASSED 


Explanation:No fault is found in the DLC card. 
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D-666 DLC level commands 
tst (end) 


Responses 


The following table provides common responses to the tst command. 
Responses for the tst command 
MAP output Meaning and action 


INVALID 
IOC 1 CARD 1 PORT 1 IS INSERVICE AND PBSY 


or 


INVALID 
IOC 1 IS INSERVICE 


Meaning: The card status is incorrect for testing. The status is either 
communications-side busy (CBSY) or perhipheral-side busy (PBSY). 


Action: None 


REQUEST FAILED 


Meaning: The card is faulty, there is another hardware problem, or the datafill is 
incorrect. 


Action: Check that the data table DLCDEV has the correct datafill for that card. 
If the datafill is correct, replace the card. 


REQUEST PASSED 
Meaning: No fault is found in the DLC card. 


Action: None 
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D-667 


DPNSS level commands 


Use the DPNSS level of the MAP to enter the Digital Private Network 
Signaling System (DPNSS) system and query and change the status of the 
links within a selected linkset. 


Accessing the DPNSS level 
To access the DPNSS level, enter the following from the CI level: 
mapci;mtc;ccs;dpnss — 


DPNSS commands 


The commands available at the DPNSS MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


Command 


actlap 
auditlink 
bsy 
deactlap 
next 

offl 

post 


prev 


querylap 


querylnk 


queryusr 
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D-668 DPNSS level commands 


Command 


DPNSS menu 


The following figure shows the DPNSS menu and status display. The insert 
with the hidden command is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks 
DPNSS CCS7 CCIS6 DPNSS 
0 Quit_ 1 RSC je: X 
2 Post_ Link name Link ST carr. 
3 (carrier) state No state state 
4 
5 0 links in post set, 0 after current link 
6 
7 Bsy_ 
8 Rts_ 
9 Off1_ 
10 
I1 Prev Hidden commands 
12 Next 
13 QueryUsr auditlnk 
14 QueryLnk 
15 QueryLAP 
16 
17 ActLAP_ 
18 DeActLAP_ 
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DPNSS level commands D-669 
actlap 


Function 
Use the actlap command to activate a LAP. 


actlap command parameters and variables 


Command Parameters and variables 


real_lap 

V 

virtual _lap 
all 


Parameters 
and variables Description 


Not currently available 
Not currently available 
The range of this variable is 0-31. 
The range of this variable is 0-31. 


The range of this variable is 0-31. 


vitual_lap The range of this variable is 0-31. 


Qualifications 


The effect of this command is temporary. The default set of LAPs will be 
reactivated on the next link or ST return to service (RTS). 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-671 
auditlink 


Function 


Use the auditlink command to run a link audit on a posted link or on all 
links. 


auditlink command parameters and variables 


Command Parameters and variables 


auditlink alarms 
all 


Parameters 
and variables Description 


Not currently available 


This parameter specifies all equipped links, but not all the links in a posted set. 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-673 
bsy 


Function 


Use the bsy command to put the current link into the manual busy (ManB) 
state. 


bsy command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter puts all the links in the ManB state. 


Not currently available 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-675 
deactlap 


Function 
Use the deactlap command to deactivate aLAP on the current link. 


deactlap command parameters and variables 


Command Parameters and variables 


deactlap 
real_lap 

V 

virtual _lap 
all 


Parameters 
and variables Description 


Not currently available 
Not currently available 
The range of this variable is 0-31. 
The range of this variable is 0-31. 


The range of this variable is 0-31. 


vitual_lap The range of this variable is 0-31. 


Qualifications 


The effect of this command is temporary. The default set of LAPs will be 
reactivated on the next link or ST RTS. 


Examples 
Not currently available 


Responses 


Not currently available 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DPNSS level commands D-677 
next 


Function 


Use the next command to make the next link in the posted set the current 
link. 


next command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-679 
offl 


Function 


Use the offl command to change the state of the current link to offline, if the 
current link state is manual busy (ManB). 


offl command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter changes the state of all the current links to offline, if the current lin 
state is manual busy (ManB). 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DPNSS level commands D-681 
post 


Function 


Use the post command to post a Digital Private Network Signaling System 
(DPNSS) link or a set of links. 


post command parameters and variables 


Command Parameters and variables 


Not currently available 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-683 
prev 


Function 


Use the prev command to make the previous link in the posted set the 
current link. 


prev command parameters and variables 


Command Parameters and variables 


There are no parameters and variables. 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-685 
querylap 


Function 


Use the querylap command to display the state of all LAPs of the current 
link. 


querylap command parameters and variables 


Command Parameters and variables 
querylap 


Parameters 
and variables Description 


Not currently available 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-687 
queryInk 
Function 


Use the queryInk command to display more information on the current 
posted link. 


queryInk command parameters and variables 


Command Parameters and variables 


queryInk There are no parameters and variables. 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DPNSS level commands D-689 
queryusr 


Function 


Use the queryusr command to display the name of the trunk using a real 
LAP. 


queryusr command parameters and variables 


Command Parameters and variables 


queryusr r 
real_lap 
all 


Parameters 
and variables Description 


Not currently available 


Not currently available 


Not currently available 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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DPNSS level commands D-691 
quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mapci, or mtc. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level nu 
ber higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DPNSS level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DPNSS level has changed to the previous menu level. 
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D-692 DPNSS level commands 
quit (continued) 


Examples of the quit command (continued) 
Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DPNSS level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DPNSS level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the display of the DPNSS level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DPNSS level commands D-693 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the DPNSS level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DPNSS level commands D-695 
rts 


Function 


Use the rts command to return the current link to the in-service ((InSv) state, 
if the the current link is in the manual busy (ManB) state. 


rts command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter returns all the links to the InSv state. 


Not currently available 


Qualifications 
Not currently available 


Examples 
Not currently available 


Responses 


Not currently available 
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D-697 


DRAM level commands 


Use the DRAM level of the MAP to access and perform maintenance on a 
DRAM module. 


Accessing the DRAM level 
To access the DRAM level, enter the following from the CI level: 
mapci;mtc;pm;post dram dram_no J 


where 


dram_no is the descrimination number of tne DRAM to be posted. 


DRAM commands 


The commands available at the DRAM MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DRAM commands 


Command 
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D-698 DRAM level commands 


DRAM menu 


The following figure shows the DRAM menu and status display. The insert 
with the hidden command is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 

TM8 PM TYPE: TM8 PM NO.: n NODE NO.: nnnn 

0 Quit PM_STATUS: state NODE STATUS: status CHKSUM: #value 
2 Post_ PP LOAD: accept PP EXECS: VALID FNAME: load_name 

3 PMS EQUIPPED: tt PM INT. #: x 

4 SITE FLR RPOS BAY_ID SHF DESCRIPTION SLOT EOPEC 

3. Trnst IM ENTRIES: y TO z 

6 Tst_ 

7 Bsy_ 

8 RTS_ 

9 OLÉL > 

10 LoadPM_ 

11 Disp_ 

12 Next_ 

= QueryPM_ Hidden command 

1:5 

16 clr 

1:7. 

18 
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DRAM level commands D-699 
bsy 


Function 


Use the bsy command to change the state of a posted PM to the ManB state 
from any other state. 


bsy command parameters and variables 


Command Parameters and variables 
pm_type pm_number 
Parameters 


and variables Description 


pm_number This variable identifies the discrimination number ofthe pm_type. The range is 
0-2047. 


pm_type This variable selects one of the PM types listed in the PM state code table in the 
PM MAP level chapter. A PM in the control position of the posted set is the defaulf. 


Qualification 
When the XPM is busied, the status displays for ManB are updated. 


Examples 
The following table provides an example of the bsy command. 


Examples of the bsy command 
Example Task, response, and explanation 
bsy dram 52.1 


Task: Post dram number 52. 


Response: OK 


Explanation: Dram number 52 is posted and in the control position. 


Responses 


The following table provides explanations of the responses to the bsy 
command. 
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D-700 DRAM level commands 
bsy (continued) 


Responses for the bsy command 


MAP output Meaning and action 


<nnn> LINES ARE IN CP BUSY STATE 
MATE ALREADY OUT OF SERVICE 

DO YOU WISH TO CARRY ON? 

PLEASE CONFIRM “YES” OR “NO” 


Meaning: The command bsy has been applied to LM bay in TAKEOVER condition 
which is performing call processing. Further action may affect calls in 
process of connection. Takeover provides improved reliability for the two 
LM bays which operate as a pair. 


When an LM is taken out-of-service the mate LM (being in service), 
takes control of all line drawers (and their line cards) of the 
out-of-service LM in addition to its own. This provides service to all line 
cards of both LMs of the LM mate-pair. The state of the taken-over LM 
remains SysB. When an LM is being taken over by its mate, the status 
display of the LM shows TOinProgress. 


Action: None 


<nnn> LINES ARE IN CP BUSY STATE 
TRANSFER TO MATE WILL AFFECT CALLS 
DO YOU WISH TO CARRY ON? 

PLEASE CONFIRM “YES” OR “NO” 


Meaning: Further action invokes takeover which transfers the call processing load 
to the mate LM bay. Takeover action causes loss of calls in process of 
connection. 


Action: None 
NO ACTION TAKEN 


Meaning: NO is entered in response to a prompt and the command is aborted. 


Action: None 


Meaning: YES is entered in response to a prompt and the PM is busied. 


Action: None 
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DRAM level commands D-701 
bsy (end) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


<pm_type> <pm_number> IS MANUAL BUSY 
NO ACTION TAKEN 


Meaning: The command bsy is applied to a PM that is already in the ManB state. 


Action: None 


<nnn> TERMINALS ARE IN CP BUSY STATE 
DO YOU WISH TO CARRY ON? 
PLEASE CONFIRM “YES” OR “NO” 


Meaning: The command bsy has been applied to a PM (other than LM) which is 
performing call processing. This response warns that further action may 
affect calls in process of connection. 


Action: None 
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DRAM level commands D-703 
clr 


Function 


Use the clr command to clear the ISTb state of the RAMP since the state 
remains until the PM is reloaded. The command clr is recommended for use 
by the maintenance support personnel. 


A parity error with the Read Access Memory (RAM) indicates a “trap” in 

PM processing. When a RAM parity (RAMP) occurs, the PM reports it to 
the CC and the header RAMP appears with status ISTb on the PM display. 
To clear the ISTb state of the RAMP, enter the command string clr ramp. 


clr command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that RAM parity is not 
cleared when the clr command is executed because the ramp parameter was not 
entered. 


This parameter specifies that the RAM parity is to be cleared. 


Qualifications 


The clr command is qualified by the following exception, restrictions and 
limitations: 


e The clr command is used when RAMP does not affect the operation of 
the PM. 


e The PM is not taken out-of-service when the RAMP can be ignored. 


e If there is no other ISTb for the RAMP, then its state changes to in 
service, and InSv is displayed. If the PM is out-of-service the RAMP 
header is not displayed. 
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D-704 DRAM level commands 
clr (end) 


Example 
The following table provides an example of the clr command. 


Example of the clr command 


Example Task, response, and explanation 


clr ramp — 


Task: Clear the ram parity of posted dram. 
Response: display 
Explanation: The header RAMP on the status display disappears and the RAM 


is cleared. The RAMP is cleared regardless of the state of the 
PM. If there is no RAMP, the command has no effect. 


Response 


The following table provides an explanation of the response to the clr 
command. 


Response for the clr command 


MAP output Meaning and action 


display 


Meaning: The header RAMP on the status display disappears and the RAMP is 
cleared. The RAMP is cleared regardless of the state of the PM. If 
there is no RAMP, the command has no effect. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DRAM level commands D-705 
disp 


Function 


Use the disp command to display a list of a posted PM type that is in a 
specified maintenance state. 


disp command parameters and variables 


Command Parameters and variables 


pm_state pm_type 


Parameters 
and variables Description 


This variable is one of the PM states listed in Tthe DRAM state code table at the 
beginning of this chapter. 


This variable selects one of the PM types listed in the PM state code table in the 
PM MAP level chapter. A PM in the control position of the posted set is the defaulf. 


This parameter is required before the PM state code 


Qualification 
If a pm_type is not entered, the display includes all PM in the specified state. 


Examples 
The following table provides an example of the disp command. 


Examples of the disp command 


Example Task, response, and explanation 


disp state offl tm8 — 
where 


offl is the state of the PM to be displayed 
tm8 is the PM type to be displayed. 


Task: Identify all DRAMs in the Offl state. 


Response: OFFL DRAM: 


Explanation: The discrimination numbers of DRAMs that are in the Offl state are 
displayed. 
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D-706 DRAM level commands 
disp (end) 
Response 


The following table provides an explanation of the response to the disp 
command. 


Response for the disp command 


MAP output Meaning and action 


<state> <pm>: <n>, <n>, 


Meaning: The display appears, where <state> and <pm> echo the specified state 
and PM type, and <n> is the discrimination number of the PM. 


Action: None 
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DRAM level commands D-707 
loadpm 


Function 


Use the loadpm command to load the peripheral program files into the 
processor of a posted PM. The PM must be in the manual busy (ManB) 
state before entering the loadpm command. 


loadpm command parameters and variables 


Command Parameters and variables 


exec | nowait 
notest 


Parameters 
and variables Description 


This parameter selects the load mode to be executives (execs) only. 


This parameter allows loadpm to be completed without the ROM test. 


This parameter allows another DRAM to be posted and loaded without waiting for 
confirmation from the previous load request. The parameter nowait also enables 
the MAP to be used for other entries while loading proceeds. Error messages are 
printed in PM logs. 


Qualifications 
The loadpm command is qualified by the following exceptions, restrictions, 
and limitations: 


e When using the loadpm command, the load file name is taken from the 
data table. The load name is displayed by the querypm command. 


e To determine the loads for each PM use the inform command. 


e When the DRAM is not loaded, the only programs that are present for 
testing are located in the ROM. If the ROM tests fail, the loadpm 
command cannot be used. If the ROM tests pass, the parameter notest 
bypasses the ROM tests. The time taken for a ROM test that is already 
known to succeed is not repeated. 


e To reload a PM, enter the loadpm command on the inactive unit, then 
enter the command swact when it is completed, and then reenter the 
loadpm command for the newly inactive unit. 


Example 
Not currently available 
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D-708 DRAM level commands 
loadpm (continued) 


Responses 


The following table provides explanations of the responses to the loadpm 
command. 


Responses for the loadpm command 


MAP output Meaning and action 
LOAD FILE NOT IN DIRECTORY 


Meaning: The system cannot find the location of the load file. The load file resides 
on tape or disk. Use the listvol command to list the disk volume, or use 
the mount command to mount the tape that has the load file on it. Fora 
description of the listvol command, refer to the chapter describing the 
DSKUT nonmenu directory in the Nonmenu Commands Reference 
Manual. For a description of the mount command, refer to chapter 
describing the SYS directory in the Nonmenu Commands Reference 
Manual. 


Action: None 


<pm_type> <pm_number> IS <status> 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for loading, where <pm_type> is a PM in 
the posted set, <pm_number> is the discrimination number of the PM, 
and <status> is one of 

CBSY 
INSV 
OFFLINE 


The PM must be ManB. 


Action: None 


<pm_type> <pm_number> OK. CHECKSUM = # hhh 


Meaning: The PM has been successfully loaded. The checksum is the value 
associated with the data loaded into the PM. 


Action: None 
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DRAM level commands D-709 
loadpm (end) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


<reason> 
NO ACTION TAKEN 


Meaning: The command cannot be executed for a reason other than those given 
in the standard response. 


Action: For DMS-100 systems equipped with Disk Drive Units (DDU) refer to the 
nonmenu directory DSKUT, and use the commands listvol and dskut. 
For DMS-100 systems equipped with magnetic tape drives (MTD), refer 
to the nonmenu directory SYS and use the commands mount and list. 
The DSKUT and the SYS nonmenu directories are discussed in the 
Nonmenu Commands Reference Manual. 
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DRAM level commands D-711 
next 
Function 


Use the next command to post the next higher PM number of the set of 
posted PM. 


next command parameters and variables 


Command Parameters and variables 


pm_type 


Parameters 
and variables Description 


This variable enables the system to select one of the PM types listed in the PM státe 
code table in the PM MAP level chapter. Use the disp command to display the list 
of PM types in the posted set. The system selects the PMs in the sequence 


displayed by this list. 


Qualifications 
None 


Example 
The following table provides an example of the next command. 


Example of the next command 


Example Task, response, and explanation 


Task: Post the next higher DRAM. DRAM 3 is the currently posted PM. 


Response: DRAM 4 


Explanation: The next higher DRAM is now posted. 


Response 


The following table provides an explanation of the response to the next 
command. 
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D-712 DRAM level commands 
next (end) 


Response for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed PM is the last in the posted set of PMs, or only 
one PM number has been posted. The display returns to the next higher 
menu level. 


Action: None 
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DRAM level commands D-713 
offl 


Function 
Use the offl command to change the state of a posted PM from ManB to 
offline. The PM is temporarily removed from service during maintenance 
action. 


offl command parameters and variables 


Command Parameters and variables 


offl There are no parameters or variables. 


Qualification 
Before the offl command is used, the PM must first be set to ManB by using 
the command bsy. 


Example 
The following table provides an example of the offl command. 


Example of the offl command 


Example Task, response, and explanation 


Task: Place the posted DRAM in the offline state. 
Response: OK 


Explanation: The poste DRAM is in the offline state. 


Responses 
The following table provides explanations of the responses to the offl 


command. 


Responses for the offl command 


MAP output Meaning and action 


Meaning: The PM is made offline. 


Action: None 
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D-714 DRAM level commands 
offl (end) 


Responses for the offl command (continued) 


MAP output Meaning and action 


<pm_type> <pm_number> IS <status>. 
NO ACTION TAKEN 


Meaning: the PM is already offline or is in the incorrect state for being made 
offline, where <pm_type> is a PM in the posted set, <pm_number> is the 
discrimination number of the PM, and <status> is one of 

CBSY 

INSV 

OFFLINE 
SYSTEM BUSY 


the PM must be ManB. 


For some PM types, REQUEST INVALID appears before the response 
NO ACTION TAKEN. 
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DRAM level commands D-715 
post 


Function 


Use the post command to select the corresponding menu and display for the 
PM or PM state. 


post command parameters and variables 
Command Parameters and variables 
pm_state 


pm_type pm_number 


Parameters 
and variables Description 


pm_number This variable identifies the discrimination number of the pm_type. 


pm_state This variable selects the state of the specified PM. The states are listed in the 
DRAM state code table at the beginning of this chapter. 


pm_type This variable selects one of the PM types listed in the PM state code table in the 
PM MAP level chapter. If the level of a DRAM node-type is already accessed, the 
default for pm_type is the PM in the control position. 


Qualification 


When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office network. 
The applicability of the parameters depends on the types of PMs that are 
present in the office configuration. For parameters that do not apply, one of 
several responses indicates that it is ignored. 


Example 
The following table provides an example of the post command. 
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D-716 DRAM level commands 
post (end) 


Example of the post command 


Example Task, response, and explanation 


post dram 2.1 
where 


2 Is the number of the DRAM to be posted 
Task: Post DRAM number 2 
Response: (Display for currently posted dram) 


Explanation: DRAM number 2 is posted. 


Responses 


The following table provides explanations of the responses to the post 
command. 


Responses for the post command 
MAP output Meaning and action 
NO PM POSTED 


Meaning: The command string post pm_type accesses a PM level without posting 
a specific PM. 


Action: None 


<pm_state> <pm_type>: NONE 


Meaning: There are no PMs in the specified state. The variable <pm_state> is 
one of the codes listed in the DRAM state code table at the beginning of 
this chapter, and pm_type echoes the posted PM. 


Action: None 
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DRAM level commands D-717 
querypm 


Function 
Use the querypm command to display information about a posted PM. The 
information is drawn from the DMS-100 data tables, and is used for 
debugging or office extensions. The information also includes the name of 
the valid load file which is used by the command loadpm. 


querypm command parameters and variables 


Command Parameters and variables 


querypm There are no parameters or variables. 


Qualifications 
The querypm command is qualified by the following: 


e The display for the querypm command is the same for all TM 
node-types. 


e If parameters flt or cntrs are entered with the command querypm at the 
TM-node levels, the parameters are ignored and the same information is 
displayed (see the Example that follows). (The parameters flt and cntr 
are common to other PM levels that also have the querypm command.) 


Example 
The following table provides an example of the querypm command. 


Example of the querypm command 


Example Task, response, and explanation 

querypm 4- 
Task: Display information about the posted DRAM. 
Response: 


M TYPE: DRAM PM NO.: 0 NODE NO.: 18 
M STATUS: InSv NODE STATUS: OK,FALSE, CKSUM: #0244 
P LOAD: VALID PP EXECS: VALID FNAME: TKTMKA02 


ite Flr RPos Bay_id Shf Description Slot EqPEC 
OST 00 BOO DCE 000 65 DRAM : 000 2X58Au 
M Entries: 0 TO 8 


E 
P 
P 
PMS EQUIPPED: 21 PM INT.#: 3 
S 
H 
T 


Explanation: Executing the querypm command results in the above display for 
the posted DRAM. 
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querypm (end) 
Response 


The following table provides an explanation of the response to the querypm 
command. 


Response for the querypm command 


MAP output Meaning and action 


PM TYPE:<pm> PM NO.:<n> NODE NO.:<nnnn> 

PM STATUS:<state> NODE STATUS:<status> CKSUM: #<value> 
PP LOAD: <accept> PP EXECS: VALID FNAME:<load_name> 
PMS EQUIPPED:<tt> PM INT.#: <x> 

Site Flr RPos Bay_id Shf Description Slot EqPEC 

IM Entries:<y> TO <z> 


Meaning: The appropriate display appears, where: 


<pm> is the type of PM. 

<n> is the discrimination number of the PM type. 

<nnnn> is the PM node number. 

<state> is one ofthe PM states listed in the DRAM state code 

table at the beginning of this chapter. 
<status> is one of 
OK 
FALSE 

<value> is a hexadecimal number for PM of node-type TM. The 
number is used to calculate the checksum (header 
CHKSUM) for each software load. After loading the 
peripheral and testing the PM, the checksum total is to 
be compared with the expected checksum total. If the 
totals match, the load is OK. If there is a mismatch, the 
load must be loaded again using the command loadpm. 
Each pm_type has a different checksum value for each 
load. 

<accept> is VALID or INVALID for the load file that the PM uses. 

<load_name> is the name of the load file that is used as a value for 
parameter |_name of the command loadpm. 

<tt> is the total of equipped PM for that office. 

<X> is 0-2047 for a location identifier of channel. See 
Channel Map Feature on page 203. 

<y>, <Z> is 0-127 for the range of PM that are posted. 


Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DRAM level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DRAM level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DRAM level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DRAM level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DRAM level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DRAM level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rts 


Function 


Use the rts command to change the state of a posted PM from ManB to SysB 
or InSv. 


rts command parameters and variables 
Command Parameters and variables 


pm_type pm_number 
sysb all 


Parameters 
and variables Description 


all This parameter returns to service all posted PMs, regardless of status. 


pm_number This variable identifies the discrimination number of the pm_type. The range is 
0-2047. 


pm_type This variable selects one of the PM types listed in the PM state code table in the 
PM MAP level chapter. A PM in the control position of the posted set is the defaulf. 


sysb This parameter returns all posted system busy PMs to service. 


Qualifications 


The rts command is qualified by the following exception, restrictions and 
limitations: 


e Before the rts command is used, the PM must first be set from Offl to 
ManB by using the command bsy. 


e As PMs are returned to service, the PM status display decrements under 
the header ManB and increments under ISTb or InSv. If the return to 
service fails, the header ManB decrements and either header CBsy or 
SysB increments by 1 for each posted PM. 


e When an XPM is made system busy (SysB state), the testing and loading 
of a return to service are automatically initiated. 


Example 
The following table provides an example of the rts command. 
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rts (continued) 


Example of the rts command 


Example Task, response, and explanation 


Task: Return the currently posted DRAM to service. 
Response: OK 


Explanation: The DRAM currently posted is returned to service. 


Responses 
The following table provides explanations of the responses to the rts 


command. 


Responses for the rts command 
MAP output Meaning and action 
CLOCK SOURCE SWITCHING TROUBLE 


Meaning: A test is applied to the LM or DCM, and the ISTb state is caused by 
clock switching problems. 


Action: None 


CS LINK UNAVAILABLE 
NO ACTION TAKEN 


Meaning: The C-side links used for messages are both out-of-service, therefore, 
the PM cannot communicate with the CC. 


Action: None 


Meaning: The specified PM is returned to service. 


Action: None 
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rts (end) 


Responses for the rts command (continued) 


MAP output Meaning and action 


<nnn> LINES ARE IN THE CP BUSY STATE 

LOAD TRANSFER FROM MATE WILL DISRUPT CALLS 
DO YOU WISH TO CARRY ON? 

PLEASE CONFIRM (“YES” OR “NO”) 


Meaning: Further action invokes takeback which transfers the call processing load 
from the mate LM bay. Takeback action causes loss of calls in process 
of connection. 


Action: None 


<pm_type> <pm_number> IS <status>. 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for returning to service, where 
<pm_type> echoes the posted PM, <pm_number> is the discrimination 
number of the PM, and <status> is one of 

CBSY 
INSV 
OFFLINE 


The PM, must be ManB. 


Action: None 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EQPEC 


Meaning: Results of tests are shown using the standard circuit display. A standard 
format, based on the DMS-100 Family equipment identification scheme, 
identifies the physical location of possible faulty circuit cards. When the 
circuit location display is part of the response to a failed test, the circuit 
cards are listed in order of the most likely cause of the fault, and 
therefore their recommended sequence of replacement. The characters 
listed under the header EQPEC are the hardware PEC of the suspected 
circuit card. shown without the prefix NT. 


None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DRAM level commands D-727 
trnsl 


Function 


Use the trnsl command to identify the various links between a posted PM 
type and the network or subsidiary peripheral module (PM). 


trnsl command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
None 


Example 
Not currently available 


Response 


The following table provides an explanation of the response to the trnsl 
command. 


Response for the trnsl command 


MAP output Meaning and action 


trnsl 

NM PAIR : NM PORT 
NM PAIR $ NM PORT 
NM PAIR 4 NM PORT 
NM PAIR 3 NM PORT 


Meaning: The display is added to the PM display, where <n> is 0 or 1 for the plane 
number and <nn> is 0-31 for the NM number to which a port is 
connected. 


Action: None 
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tst 


Function 
Use the tst command to invoke test routines on a posted PM. 


tst command parameters and variables 


Command Parameters and variables 
pm_type pm_number 
Parameters 


and variables Description 


pm_number This variable identifies the discrimination number of the pm_type. The range is 
0-2047. 


pm_type This variable selects one of the PM types listed in the PM state code table in the 
PM MAP level chapter. A PM in the control position of the posted set is the defaulf. 


Qualifications 
None 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


tst dram 2. 
where 


2 is the descrimination number of the DRAM to be tested. 
Task: Test DRAM number 2. 


Response: OK 


Explanation: The test was performed and the PM passed. 


Responses 


The following table provides explanations of the responses to the tst 
command. 
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tst (continued) 


Responses for the tst command 
MAP output Meaning and action 
CLOCK SOURCE SWITCHING TROUBLE 


Meaning: A test is applied to LM or DCM, and the ISTb states is caused by clock 
switching problems. 


Action: None 


OSVCE TEST INITIATED 


Meaning: Out-of-service testing is being performed on the posted PM which is in 
the ManB or SysB state. 


Action: None 


CS LINK UNAVAILABLE 
NO ACTION TAKEN 


Meaning: The C-side links used for messages are both out-of-service, therefore, 
the PM cannot communicate with the CC. 


Action: None 


INSVCE TESTS INITIATED 
<pm_type> <pm_number> TST PASSED. 


Meaning: In-service testing is being done on the posted PM which is the InSv or 
ISTb state. PASSED appears when testing is satisfactorily completed. 


Action: None 


Meaning: The test was performed and the PM passed. 


Action: None 
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tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


<pm_type> <pm_number> IS <status> 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for testing, where <pm_type> echoes the 


posted PM, <pm_number> is the discrimination number of the PM, and 
<status> is one of 


CBSY 
OFFLINE 


The PM must be ManB. 


Action: None 


<pm_type> <pm_number>, CHECKSUM=# <hhh>, AGREES. 


Meaning: The test passes. The checksum agreement referred to (AGREES) is 
between a recent value for the data in the PM and the load-time value as 


stored in the central control. This confirms that the PM load has not 
been completed. 


None 


REQUEST INVALID 


Meaning: In-service tests occur if the selected PM is in the InSv state, or 
out-of-service tests occur if it is in the ManB or SysB state. 


Action: None 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EQPEC 


Meaning: Results of tests are shown using the standard circuit display. A standard 
format, based on the DMS-100 Family equipment identification scheme, 
identifies the physical location of possible faulty circuit cards. When the 
circuit location display is part of the response to a failed test, the circuit 
cards are listed in order of the most likely cause of the fault, and 
therefore their recommended sequence of replacement. The characters 
listed under the header EQPEC are the hardware PEC of the suspected 
circuit card. shown without the prefix NT. 


None 
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tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


TEST RESOURCES IN USE 
NO ACTION TAKEN 


Meaning: Test facilities are already in use for other maintenance actions. 


Action: None 
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D-733 


DRM level commands 


Use the DRM level of the MAP to perform control and review functions for 
a distributed recording manager (DRM). 


Accessing the DRM level 
To access the DRM level, enter the following from the CI level: 
mapci;mtc;appl;oamap;drm ~- 


DRM commands 


The commands available at the DRM MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DRM commands 


Command 


audit 
copy 
dat 
demount 
info 
monitor 


mount 


quit 


rename 
reset 


rotate 
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DRM commands (continued) 


Command 


DRM menu 
The following figure shows the DRM menu and status display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 

DRM DCAP OAMAP EIO 

0 Quit 1 ISNCP ACBLNK . 
2 
3 -Infó 
4 Audit_ ACB : ACBLNK TSI : TSILNK DRM : 
5 Rotate_ 

6 Rename_ 
7 Mount_ 
8 Demount_ 

9 Reset_ 


O DAT_ 
1 View_ 

12 tcopy_ 
13 Monitor_ 
4 
5 
6 
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audit 


Function 


Use the audit command to request a comprehensive audit on an application 
and its resources. 


Three audit types are performed: 
e Application 

e Space 

e Volume 


audit command parameters and variables 


Command Parameters and variables 


actn 
node_nm 


volume 


Parameters 
and variables Description 


This is a system default. It may replace a node name variable to refer to the 
application's active device and is automatically selected when no node_nm 
variable is specified. 


Note: The active node is where the application delivers its data to DRM for 
recording and is not necessarily the node containing the application's active file. 


This parameter specifies that all audit types (REC, SPACE, VOL, APPL, FDIR) be 
performed on the selected node. 


This parameter specifies that an application audit be performed on the selected 
node. 


This parameter specifies that a DRMFDIR audit be performed on the selected nodp. 
This variable specifies which node is to be audited. 


This parameter specifies that a recording audit be performed on the selected nodd. 


This parameter specifies that a space audit be performed on the selected node. 
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audit (continued) 


audit command parameters and variables (continued) 


Parameters 
and variables Description 


vol This parameter specifies that a volume audit be performed on the selected node. 


volume This variable identifies the volumes to audit. It may be a volume name, volume 
number, or all from table DRMPOOL. 


Qualifications 
None 


Example 
The following table provides an example of the audit command. 


Example of the audit command 


Example Task, response, and explanation 
audit occ appl fp0 . 
Task: Perform an application audit for OCC on FPO. 


Response: 
AUDIT OCC APPL Comleted on FPO. 
|---- Counts form 92.05/12 20:04:13 ---- 
|---ERROR CONDITIONS--- REQUEST PEND | 
STATUS TBL SPA REQ FER VER SWE RTR ROT AUD 


ACTIVE 


Explanation: The response indicates that theoperation was swuccessful, and the 
counts displayed were Iwast reset to 0 on the date and time given. 


Responses 


The following table provides explanations of the responses to the audit 
command. 
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audit (continued) 


Responses for the audit command 


MAP output Meaning and action 


AUDIT OCC APPL Completed on FPO. 


| Counts from 92/05/12 20:04:13 --- | 
| ---ERROR CONDITIONS--- REQUESTS PEND | 


STATUS TBL SPA REO FER VER , RTR ROT AUD 


ACTIVE 


Meaning: The operation was successful, and the counts displayed were last reset 
to 0 on the date and time given. 


Action: None 


AUDIT OCC FDIR Completed on FPO. 


InSv Number of files 
Active files 
Unprocessed files 
Processed files 
Removed files 


Meaning: The operation was successful. File counts from the DRM directory 
maintained on FPO are displayed. 


Action: None 
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audit (continued) 


Responses for the audit command (continued) 


MAP output Meaning and action 
AUDIT OCC REC Completed on FPO. 


REC Records over last capture interval 
AUDIT Avg records per hour 
Avg volume space used per KB/min 
Avg volume space used per KB/hr 
Last capture interval :03:06 
Begin-end of last capture 50:09 = 172532175 
Next schedule capture time 4 :09 
Last manual capture time 15:46:22 


Meaning: The operation was successful. It was completed on FPO at 17:53:15. 


Note: Because the scheduler on each node performs this audit every 
ten minutes, the last capture interval will never exceed ten minutes. 
When issuing this command, be aware of the next scheduled capture 
time so that the command will not cause the next capture interval to be 
too short. The longer the capture interval, the more realistic the 
averages. If the next scheduled capture time is approaching, it is better 
to allow the scheduler to perform the audit. Then use the info <appl> rec 
command to view the results. 


Action: None 
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audit (continued) 


Responses for the audit command (continued) 


MAP output Meaning and action 


AUDIT OCC VOL ALL Completed on FPO. 
| - Counts from 92/05/12 20:04:13 - | 


| ---VOLUME ERR--- ----FILE ERR----| 


STATE SP AC FL IO FS IF CR OP WR CL RN DL 


OK 0000000 


00 
IN ERROR 02 1 0 0 0 100 


LAST ERROR DETECTED: 


Device unavailable 
OPERATION: ACCESS 


Meaning: The operation was successful and the VOLUME ERR and FILE ERR 
counts were last reset at the time indicated. The error descriptions are 


listed for each volume that is INERROR along with the operation that 
caused the error. 


Action: None 


AUDIT OCC VOL DKOOFTF1 Completed on FPO. 


Vi SZ (M) R% N STATE 


Meaning: The operation was successful and the volume is OK for recording. The 


results of the audit are displayed identically to the INFO <appl> VOL 
response. 


If the volume status after the audit had been INERROR or SHUTDN, the 


response would provide the error information as shown in the example 
for AUDIT <appl> VOL ALL. 


Action: None 
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audit (end) 


Responses for the audit command (continued) 


MAP output Meaning and action 


AUDIT OCC SPACE Completed on FPO. 


InSv P space recovered during audit 

POOL Volume chosen for next file 

SPACE Total space MB 
Free space M 
Active space 
Unprocessed space... 
Processed space 
Removed space 
Non-usable spac 
Available recording space. (free + P). 


Meaning: The response indicates that the operation was successful and displays 
the results. The “P space recovered” is the amount of new free space 
made available due to ’P’ file deletion that occurs during the space audit. 


None 


Execution of the AUDIT <appl> ALL/VOL/FDIR commands may impact the 
recording/transfer throughput on the target node for the duration of the 
audit. These commands (ALL in particular) are CPU intensive. 


Meaning: 


Action: None 
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copy 


Function 
Use the copy command to copy Device Independent Recording Package 
(DIRP) files that reside on the Computing Module (CM) or Ethernet 
Input/Output Controller (EIOC) onto the Distributed Recording Manager 
(DRM) system. The DIRP file that resides on CM or EIOC is copied onto 
FP and the file is added to the DRM file directory. The DIRP file continues 
on CM or EIOC disks. 


copy command parameters and variables 


Command Parameters and variables 


vol_ nm file_nm from_nd to nm | | 


filestate 


Parameters 
and variables Description 


file_nm This variable specifies the complete DIRP filename. This file name can be obtaingd 
by browsing through table DIRPHOLD. 


vol_nm This variable specifies the DIRP volume name that houses the DIRP file to be 
copied. 


from_nd This variable specifies the node from which the DIRP file has been copied. Valid 
entries are: 
cm 
eioc 


nochange This default parameter specifies that the DIRP file on the CM/EIOC is to be left in 
the same file state as before, and will be the result when nothing is entered for the 
filestate variable. 


filestate This variable specifies the file state of the file copied to DRM. The file state of the 
copied file is changed as specified. The file state cannot be changed to “A” file state 
while copying to DRM. lts valid entries are: 


u specifies the status of the file as closed and unprocessed 
p specifies the status of the file as closed and processed 
r specifies the status of the file as closed and removed. 


This variable specifies the DRM application to which the file must be added. The 
DRM filename is obtained from the timestamp in the DIRP filename. The DRM file 
is placed in the DRM file directory under the specified application. 
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copy (continued) 


Qualifications 
The copy command is qualified by the following exceptions, restrictions, 
and limitations: 


e Only DIRP files can be copied and added to DRM file directory. 
e A complete DIRP filename has to be mentioned in the command line. 
e Only closed DIRP files can be copied to DRM file directory. 


e The closed DIRP files can be copied and added to DRM file directory as 
only “P”, “R”, or “U” files. DIRP files can not be copied and added to 
DRM file directory as an “A” file. 

e The FP must have enough space to copy the DIRP file. 

e The DIRP file that is being currently transferred by AFT (AUTOXFER) 
cannot be moved to DRM. 


e Only on DRM copy can be executed at any given time. 


Example 
The following table provides an example of the copy command. 


Example of the copy command 


Example Task, response, and explanation 


copy c000occ u9111071240ama cm occ p— 
where 


c0000cc is the DIRP volume name 

u9111071240 is the DIRP filename 

cm is the node from which the file has been copied 

occ is the application name to which the file must be added 


Task: Copy DIRP files from CM to the FP 


Response: Copied to DRM file: 
PN9111071240000CC 
Copying record number: 100 
Copying record number: 200 


DRM COPY DONE 
OPERATION SUCCESSFUL 


Explanation: The file is added to DRM file directory under OCC application. THe 
state of the DIRP file will be change to P. The new file is named 
PN9111071240000CC. 
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copy (continued) 
Responses 


The following table provides explanations of the responses to the copy 
command. 


Responses for the copy command 


MAP output Meaning and action 


Buffer not available 
OPERATION FAILED 
(or) 
Resource not available - TRY LATER 
OPERATION FAILED 


Meaning: The buffers/resources necessary to execute the copy command are not 
available. The copy command is terminated. 


Action: None 


Caution: This response is a warning that the CM/EIOC is experiencing 


problems allocating resources (buffers, etc.) to execute the copy 
command. 


Command blocked by another DRM COPY command - TRY LATER! 
OPERATION FAILED 


Meaning: The copy command was issued while the DRM COPY software was 


already processing a copy command that was issued previously to this 
one. 


Wait until the current copy command is executed. The copy command 


can be issued after the current copy command has finished its execution 
of the command. 
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copy (continued) 


Responses for the copy command (continued) 
MAP output Meaning and action 

Copied to DRM file: 
UN911107122000AMA 


Copying record number: 100 
Copying record number: 200 


DRM COPY DONE 
OPERATION SUCCESSFUL 


Meaning: The system successfully processed the command. A message “copying 
record number: xx” is displayed after copying every 100th record. 


Action: None 


DIRP file locked by AUTOXFER - TRY LATER 
OPERATION FAILED 


Meaning: The DIRP file that was requested to be copied onto DRM is currently 
being transferred or processed by AFT. 


Action: Enter a different file name that is not currently being transferred or 
processed. Browse through table DIRPHOLD and obtain a different file 
name to copy. 


DIRP File not found 
OPERATION FAILED 
(or) 
DIRP file info not found 
OPERATION FAILED 


Meaning: The system cannot find the specified DIRP filename on the CM/EIOC 
volume. 


Action: Obtain the correct filename from table DIRPHOLD on the CM or on the 
ElOC. 
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copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


DIRP file not in TABLE DIRPHOLD 
OPERATION FAILED 


Meaning: The DIRP file that was requested to be copied onto DRM is not present 
in table DIRPHOLD. 


Action: Enter a file name that is present/datafilled in table DIRPHOLD. Browse 
through table DIRPHOLD and obtain a different file name to copy. 


DRM APPL name NOT VALID 
OPERATION FAILED 


Meaning: You attempted to copy a DIRP file to a DRM file that belongs to an 
application unknown to the system. 


Action: The DRM application mentioned in the command line is not registered 
with DRM. The info command in the MAPCI;MTC;APPL;OAMAP;DRM 
level of the MAP displays all the applications registered with DRM. 


DRM file deleted 
OPERATION FAILED 


Meaning: The copy command failed. 


Action: Look at the error condition that terminated the DRM COPY command. 


Error reading DIRP file 
OPERATION FAILED 


Meaning: The copy command failed due to a file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties, or the file is inaccessible due to invalid device status or due 
to a restart on the node (CM or EIOC). 
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D-746 DRM level commands 
copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Error while writing to DRM file 
OPERATION FAILED 

(or) 
Error while writing and closing DRM file 
OPERATION FAILED 


Meaning: The copy command failed due to a file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
invalid device status or due to a restart on the node (CM or FP). The file 
system error message is displayed for diagnostics purposes to help 
correct the problem. 


Error writing to buffer 
OPERATION FAILED 


Meaning: An error condition has occurred on the EIOC while writing to the buffer to 
be senttothe CM. The copy command is terminated. 


Action: None 


Caution: This response is a warning that the EIOC is experiencing 
difficulties while writing to the buffers to be sent across to CM. 


Invalid buffer sequence 
OPERATION FAILED 


Meaning: An error condition has occurred due to out of sequence arrival of buffers 
from EIOC. The copy command is terminated. 


Action: None 


Caution: This response warns that the buffers are arriving out of 
sequence from EIOC. 
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DRM level commands D-747 
copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Invalid DIRP file hold state 
OPERATION FAILED 


Meaning: The file hold state of the DIRP file that was requested to be copied onto 
DRM is invalid. 


Action: Enter a file name with a valid hold state. Browse through table 
DIRPHOLD and obtain a different file name to copy. 


Invalid DIRP filename 
OPERATION FAILED 


Meaning: You issued the copy command with an invalid DIRP filename (i.e., invalid 
“from_DIRP_filename” parameter). 


Action: Re-issue the copy command with the correct DIRP filename. 


Invalid DIRP volume name 
OPERATION FAILED 


Meaning: You issued the copy command with an invalid DIRP volume name (i.e., 
invalid “from_volume” parameter). 


Action: Re-issue the copy command with the correct DIRP volume name. 


Invalid optional parameter 
OPERATION FAILED 


Meaning: You issued the copy command with an invalid optional parameter. 


Action: Re-issue the copy command with the correct optional parameter. The 
valid optional parameter is “nochange”. The default is “change”. 


Necessary package for copying EIOC files not present 
OPERATION FAILED 


Meaning: The copy command was issued because the necessary software 
package for copying ElOC files onto DRM is not present on the switch. 


Action: Obtain the necessary software package to copy DIRP file on the EIOC 
onto DRM. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-748 DRM level commands 
copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Necessary package for DRM COPY not present 
OPERATION FAILED 


Meaning: The copy command was issued because the necessary software 
package for the copy command is not present on the switch. 


Action: Obtain the necessary software package to copy DIRP file onto DRM. 


No response from EIOC 
OPERATION FAILED 


Meaning: An error condition has occurred on the EIOC, and there is no response 
from EIOC. The copy command is terminated. 


Action: None 


Caution: This response is a warning that a communication problem 
exist between the CM and ElOC, either due to instable ElOC link or due 
to a restart on the EIOC. 


Non-Active volumes not large enough or unavailable 
OPERATION FAILED 


Meaning: You attempted to copy a DIRP file to a DRM file, and the volumes 
allocated to DRM application do not have enough space to copy the 
DIRP file. 


Action: Increase the recording space for that application to copy the DIRP file. 
The recording space can be increased by mounting volume against the 
application or by reducing the “retention period” in the table DRMAPPL 
for the application. 


Source device must be a disk device 
OPERATION FAILED 


Meaning: The device on which the DIRP file exists must be a disk device. The 
copy command is terminated. 


Action: Obtain the DIRP file that resides on disk devices. 
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DRM level commands D-749 
copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Unable to close DIRP file 
OPERATION FAILED 


Meaning: The copy command failed due to a file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties, or the file is inaccessible due to an invalid device status or 
due to a restart on the node (CM or ElOC). 


Unable to close DRM file 
OPERATION FAILED 


Meaning: The copy command failed due to an FTFS file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
invalid device status or due to a restart on the node (CM or FP). 


Unable to create DRM file 
OPERATION FAILED 


Meaning: The copy command failed due to an FTFS file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
serious difficulties. 


Unable to delete DRM file 
OPERATION FAILED 


Meaning: The copy command failed due to an FTFS file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
invalid device status or due to a restart on the node (CM or FP). 
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D-750 DRM level commands 
copy (continued) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Unable to open DRM file 
OPERATION FAILED 


Meaning: The copy command failed due to an FTFS file system error. 


Action: None 


Caution: This response indicates that the file system is experiencing 
difficulties. It also could indicate that the file is inaccessible due to 
invalid device status or due to a restart on the node (CM or FP). 


Unable to send buffer to CM 
OPERATION FAILED 
(or) 
Unable to send message to CM 
OPERATION FAILED 


Meaning: An error condition has occurred on the EIOC and the EIOC is unable to 
send the buffer/message across to CM. The copy command is 
terminated. 


Action: None 


Caution: This response is a warning that a communication problem 
exists between the CM and EIOC, either due to instable ElOC link or 
due to a restart on the ElOC. 


Unable to send message to EIOC 
OPERATION FAILED 


Meaning: An error condition has occurred on the CM and the CM is unable to send 
the message across to EIOC. The copy command is terminated. 


Action: None 


Caution: This response is a warning that acommunication problem 
exists between the CM and ElOC, either due to an instable ElOC link or 
due to a restart on the ElOC. 
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DRM level commands D-751 


copy (end) 


Responses for the copy command (continued) 


MAP output Meaning and action 


Volume not found 
OPERATION FAILED 


Meaning: You attempted to copy a DIRP file from the DIRP volume that does not 
exist. 


Action: Enter a different volume name that has been mounted against the 
subsystem. Browse the tuple in table DIRPPOOL and obtain the volume 
name that can be used to copy the DIRP file to a DRM file or list all 


volumes that exist on CM/EIOC by typing “print rootdir” from the Cl 
prompt. 
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DRM level commands D-753 
dat 


Function 
Use the dat command to copy Distributed Recording Manager (DRM) files 
to and from Digital Audio tape (DAT) or to query information about files on 
a DAT tape. 


dat command parameters and variables 
Command Parameters and variables 


dat_drive node_nm noinit 
init 


applid Bi | 


Parameters 
and variables Description 


applid This variable is used with the write command. If entered, it specifies the ID (key) 
of an application in table DRMAPPL. If not supplied, the default is a request to 
display all application IDs known to DRM (all the keys from table DRMAPPL). 


dat_drive This variable specifies the name of the DAT drive to be mounted. The DAT drive 
format is CTyy, where yy is the DAT drive number. 


This is the eject parameter which may be entered as e or the entire word, eject. 
This parameter causes the currently mounted DAT tape to be demounted. The tape 
is ejected physically from the DAT tape drive. 


Before any other DAT commands are issued, another tape must be mounted. 


filetmpl This variable is required if an application ID is supplied. The file name template mhy 
consist of the first character of a file name followed by any number of characters 
that sufficiently identifies one or more files. It must begin with U, PR or $. The $ 
may be used at the beginning or middle of a file name template to represent a single 
character or at the end to represent a string of characters. 


If the template is not a complete file name, a list of matched names are displayed; 
one of the names may be selected for the operation. 
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D-754 DRM level commands 
dat (continued) 


dat command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is used with the mount command. When a mount is issued with an 
init variable, any previous contents of the tape are overwritten. Ifthe tape containgd 
data, it is lost. Anew VOLID is written on the tape indicating that it is aDRM tape 


Any subsequent WRITES begin at the beginning of the tape. 


The init variable must be specified when MOUNTing a DAT tape for the first time, 
otherwise the MOUNT will fail. 


When a MOUNT is issued without the init variable, the tape is examined to 
determine whether or not this is a DRM tape. If not, notification is given; then the 
tape is ejected. The tape may be reinserted and remounted with the init variable. 
If the tape is determined to be a DRM tape, it is ready for use. Any subsequent 
WRITE appends to the end of the tape preserving the current contents. 


This is the mount parameter which may be entered as m or the entire word, mount. 
This is the mount parameter and may be entered as m or entire word, mount. Befpre 
the other commands (besides QUERY) may be used, a mount must be issued to 
logically mount the tape that is currently inserted in the DAT tape drive that is 
specified by the second parameter of the command. Once the tape is mounted, ahy 
of the other parameters, w, v, r, and e, reference the currently mounted tape. The 
tape remains mounted until an e[ject] command is issued. This parameter accept$ 
the following parameters: dat drive and init. 


This variable specifies the name of the node where the DAT device reside. lt is orly 
used in the mount parameter and follows the DAT device name. 


This parameter displays information on currently mounted DAT devices. 


This is the restore parameter which may be entered as r or the entire word, restorp. 
This parameter allows you to copy a DRM file from tape back to disk. It is a file that 
was previously copied to tape by way of a DRM WRITE operation. 
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DRM level commands D-755 
dat (continued) 


dat command parameters and variables (continued) 


Parameters 
and variables Description 


This is the verify parameter which may be entered as v or the entire word, verify. 
This parameter scans the contents of the currently mounted tape and displays 
information about the files that are on the tape. 


No files are copied to tape or disk as a result of this operation. 


This is the write parameter which may be entered as w or the entire word, write. 
This parameter specifies that a file be written to the DAT that is currently mounted 
The file is appended to the end of the tape. If the tape has just been mounted wit 
the init variable, no files are currently on the tape, therefore, it starts at the 
beginning. 


Qualifications 
None 


Example 
The following table provides an example of the dat command. 


Example of the dat command 
Example Task, response, and explanation 
dat query -! 
Task: Display information on currently mounted DAT devices. 


Response: Device name: Node: Last mounted by CI: Status: 


CTO2 FPO MAP32 In Use 
CTO2 FP1 MAP30 In Use 
CTO3 FPO MAP41 Free 


Explanation: The name of the node where each mounted DAT device resides is 
displayed. This is the node name specified in the mount 
parameter. 


The “Status” field indicates whether the mounted device is being 
used by the “Last mounted by Cl” MAP terminal. “In Use” means 
that the device is being used and cannot be remounted by another 
Cl. “Free” means that another Cl terminal can remount the device. 
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D-756 DRM level commands 
dat (continued) 


Responses 
The following table provides explanations of the responses to the dat 


command. 


Responses for the dat command 
MAP output Meaning and action 
DAT Tape is not a DRM tape. 


Meaning: You attempted to MOUNT a tape without the init option, and the tape has 
not previously been inited for use by DRM. 


Action: Remount the tape with the init parameter or use a different tape. 


Ejecting tape ... Tape ejected. 
Meaning: An eject request was issued. 


Action: None 


File UN9205090109000CC already exists in the DRM directory. Do you wish 
to overwrite it (Y or N) ? 


Meaning: A restore command was issued, and the file to be restored from tape 
already exists in the DRM directory. 


Action: To proceed with the restoration, enter Y. The version of the file on disk is 
deleted and replaced with the version on tape. To stop the procedure, 
enter N. 


File UN9205090109000CC cannot be restored to disk. There is insufficient 
disk space. 


Meaning: A restore command was issued, and there is insufficient disk space 
available to restore the indicated file. 


Action: There are two things that may be done to increase the amount of 
available space. First, mount another volume for the given application, 
increasing the amount of available space. Second, back up other files to 
tape and ensure that they have been processed (in the P state) so that 
they are eligible for deletion. 
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DRM level commands D-757 
dat (continued) 


Responses for the dat command (continued) 


MAP output Meaning and action 


File UN9205090109000CC is being restored to the DRM disk .. Restoration 
complete. 


Meaning: A restore command was issued. 


Action: None 


Mounting tape CTO5 
Tape CTO5 is mounted. 


Meaning: The system successfully mounted the tape. 


Action: None 
OPERATION FAILED. Copy of active file is not permitted. 
Meaning: A write command was issued attempting to back up the active file. 


Action: Wait until the next ROTATE (this may be forced manually), and then 
copy the file to tape. 


OPERATION FAILED: CTO5 in use by another CI. 


Meaning: You attempted to MOUNT a tape, and the tape drive is already in use by 
some other Cl process. 


Only one process at a time can own the tape drive. When attempting to 
mount the tape but another process already has a tape mounted in this 
drive, the operation cannot proceed. 


Action: Wait until the tape drive is free, or EJECT the tape from the Cl to which it 
is mounted. 


OPERATION FAILED: DAT1 is not a valid device name. 


Meaning: You attempted to MOUNT a tape, and the tape drive is not a valid DAT 
drive name. 


Action: Check the Device Inventory table (FPDEVINV) for the information 
needed to create DAT drive names in this format: 


CTyy 


where xx is the FP number, and yy is the device number. 
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D-758 DRM level commands 
dat (continued) 


Responses for the dat command (continued) 
MAP output Meaning and action 
OPERATION FAILED DUE TO UNEXPECTED DAT TAPE ERROR. 


Meaning: An unrecoverable error occurred with tne DAT Tape or DAT Tape Drive. 
An alert is generated to record the error condition. 


Action: Check the system log to discover the nature of the problem. 
OPERATION FAILED. File belongs to unregistered application. 


Meaning: A restore command was issued attempting to restore a file that belongs 
to an application unknown to the system. 


Action: Wait for the application to initialize, then reenter the restore command. 
OPERATION FAILED. Invalid application id specified. 

Meaning: A write command was issued specifying an invalid application ID. 

Action: Reenter the command specifying a different application id. If necessary, 


issue a write command with no other parameters to see a list of valid 
application IDs. 


OPERATION FAILED: It is necessary to MOUNT a tape before performing this 
operation. 


Meaning: A write, verify, restore, or eject command was issued without having a 
tape currently mounted. 


Action: MOUNT a tape and repeat the request. 


OPERATION FAILED: Maximum devices mounted. 


Meaning: You attempted to MOUNT a DAT, and the maximum number is already 
mounted. 


Action: A DAT must be EJECTed by one of the other Cl processes. 


OPERATION FAILED. No files match the specified template. 


Meaning: A write or a restore command was issued specifying a filename 
template, and the system can find no files matching the template. 


Action: Reenter the command specifying a different filename template. If 
necessary, QUERY the DRM filelist or VERIFY the tape to see what files 
are present. 
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DRM level commands D-759 
dat (continued) 


Responses for the dat command (continued) 
MAP output Meaning and action 
OPERATION FAILED: Please make sure that a tape is in the DAT tape drive. 


Meaning: A mount command was attempted without a tape physically present in 
the tape drive. 


Action: Install a DAT in the drive and reissue the command. 
OPERATION FAILED: Tape is WRITE PROTECTED. 


Meaning: A MOUNT CTyy INIT or a WRITE on a tape that has write protection 
enabled is attempted. 


Action: EJECT the tape. Remove the write protection. Remount the tape and 
proceed. 


OPERATION FAILED While attempting to access file: UN9205090109000CC the 
following file system error occurred: Input/Output error 


Meaning: The DAT operation failed due to a file system error. 


Action: Caution: This response is a warning that the file system is experiencing 


serious difficulties. The file system error message is displayed for 
diagnostics purposes to help correct the problem. 


OPERATION SUCCESSFUL: The device was already mounted. 
Meaning: A DAT tape was remounted that was already mounted in DRM but not 
owned by a Cl process. (See the previous DAT QUERY responses for 


further information.) 


Action: None 


OPERATION SUCCESSFUL: 


The device was already mounted. INIT option ignored until DAT is 
EJECTed. 


Meaning: A DAT tape was remounted that was already mounted in DRM but not 
owned by a Cl process, and the init option was specified, for example, 
DAT MOUNT FPOOCT04 INIT. 
See the DAT QUERY responses, above, for further information. 


Action: If the DAT is to be initialized, then it must be EJECTed and reMOUNTed 
with the init option. 
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D-760 DRM level commands 
dat (continued) 


Responses for the dat command (continued) 


MAP output Meaning and action 
Tape contains: 


UN9205090109000CC 92/06/26 8 


Meaning: A verify command was issued. For each file on the tape, the filename, 
creation date, and size in blocks is shown. 


Action: None 


These files match the supplied filename template: 


UN9205062028000CC 
UN9205062055000CC 
UN9205080300000CC 
UN9205080444000CC 
UN9205080453000CC 
UN9205080833000CC 


Select a file number or enter QUIT: 


Meaning: A write command was issued specifying a filename template matching 
more than one filename. 


Action: Enter either the number of the filename to be written to tape or “Quit” to 
abort the operation. 


These files match the supplied filename template: 


UN9205062028000CC 
UN9205062055000CC 
UN9205080300000CC 
UN9205080444000CC 
UN9205080453000CC 
UN9205080833000CC 


Select a file number or enter QUIT: 


Meaning: A restore command was issued specifying a filename template matching 
more than one filename. 


Action: Enter either the number of the filename to be restored to tape or “Quit” to 
abort the operation. 
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DRM level commands D-761 
dat (end) 


Responses for the dat command (continued) 


MAP output Meaning and action 


WRITING File UN9205090109000CC 
OPERATION SUCCESSFUL 


File UN9205090109000CC is written. 
Meaning: A write command was issued. 


Action: None 


WRITING File UN9205090109000CC 
Writing failed. There is not enough room on the tape to complete the 
file copy. 


Meaning: A write command was issued, but the tape does not have enough room 
to accommodate the file being written. 


Action: Copy the file again onto a fresh tape. 
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DRM level commands D-763 
demount 


Function 


Use the demount command to remove a volume from a recording 
application’s pool, making the volume and its contents inaccessible to the 
recording application/system. 


demount command parameters and variables 
Command Parameters and variables 


demount applid no_vol no_vol no 
volume volume_no 


Parameters 
and variables Description 


This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, the default is a request to display all application IDs known to DRM (all 
the keys from table DRMAPPL). 


This default parameter, which is never entered, indicates that no volume variable 
has been entered or specified. 


This default parameter, which is never netered, indicates that no volume_no 
variable has been entered or is specified. 


This variable specifies the volume being demounted. It must be a volume that is 
in the application’s pool in table DRMPOOL. Ifthe volume_no is specified, this 
variable is not required. 


volume_no This variable specifies the number of the volume in the application's pool in table 
DRMPOOL and has a range of 0-17. This variable is not required if a volume is 
specified. 
Qualifications 
None 
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D-764 DRM level commands 
demount (continued) 


Example 
The following table provides an example of the demount command. 


Example of the demount command 


Example Task, response, and explanation 
demount occ dk00occ1 . 


Task: Deallocate volume DK000CC1 from OCC’s pool in table 
DRMPOOL. 


Response: OPERATION SUCCESSFUL: 
Volume DKOOOCC1 has been 
removed from OCCPOOL. 


Explanation: Volume DK0000CC1 was removed from OCCPOOL. 


Responses 


The following table provides explanations of the responses to the demount 
command. 


Responses for the demount command 


MAP output Meaning and action 


OPERATION SUCCESSFUL: Volume DKOOOCC1 has been removed from OCCPOOL. 


Meaning: This response indicates the successful performance of the command 
demount occ dk000cc1. 


Action: None 


OPERATION FAILED: The requested volume is not allocated. 


Meaning: The demount command failed because the specified volume does not 
exist in the application's pool in table DRMPOOL. 


Action: A list of the mounted or allocated volumes may be obtained by listing the 
application's tuple in table DRMPOOL or by using the info <applid> vol 
command. 
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DRM level commands D-765 
demount (continued) 


Responses for the demount command (continued) 


MAP output Meaning and action 


OPERATION FAILED: Volume DK000CC1 cannot be demounted. 
Reason: Volume contains ACTIVE file 


Meaning: The demount command failed because the specified volume contains 
the application’s ACTIVE file. All files on a volume must be either U 
(unprocessed), P (processed), or R (removed) before the volume can be 
removed from the application’s pool. 


Use the rotate command to close the current ACTIVE file on the volume, 
and open a new ACTIVE file on an alternate volume. Ifthere are no 
alternate volumes available for the ACTIVE file, then the volume may not 
be demounted. An application must always have at least one volume 
available for the ACTIVE file. 


OPERATION SUCCESSFUL: Volume DKOOOCC1 has been removed from OCCPOOL. 


Meaning: The system was able to de-allocate the volume for OCC's pool in table 
DRMPOOL. 


Action: None 
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D-766 DRM level commands 
demount (end) 


Responses for the demount command (continued) 


MAP output Meaning and action 


Volume DKOOVOL1: Does not contain an ACTIVE file, but it is the only 
volume allocated to OCC. Demounting this volume will disallow further 
recording by OCC until additional volume space is made available. 


Perform Demount operation? (YES/NO, or QUIT): 


Meaning: The demount command requires a confirmation from you because the 
specified volume is the only one available for recording. 


Action: Enter either yes or no. Yes tells the system to proceed with the demount 
procedure; no aborts the demount procedure. 


Be aware that entering yes disallows recording of the application’s data 
until more volume space is made available in one of the following ways: 


-U (unprocessed) or R (removed) files are renamed to P (processed), or 
a file is deleted on a volume in FULLU state, and then an AUDIT or 
RESETVOL is done to change its state to OK. 

-volumes in ERROR state are repaired and then returned to service 
using the resetvol command. 

-volumes are added to the application’s pool in DRMPOOL by way of the 
mount command. 


Note: lf the specified volume contains the ACTIVE file, and no volumes 
are available for recording (ROTATE), then the volume may not be 
demounted. 


When a volume is demounted, or removed using this command, its contents 
are no longer accessible and protected by the recording system. The 
files on demounted volumes are vulnerable to deletion by the system and 
craftpersons. The user should ensure that the files are no longer 
needed, that is, all files are “processed” before demounting the volume. 


Meaning: 


Action: None 
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DRM level commands D-767 
info 


Function 


Use the info command to display registration, status, volume, file, audit and 
rotate information. Also use this command to list the applications known to 
the Distributed Recording Manager (DRM). 


info command parameters and variables 


Command Parameters and variables 


all 
filetmpl 
fstates 


all 
volume 


Parameters 
and variables Description 


This parameter preceded by the applid, requests registration, audit, volume, file, and rotate 
information. 


This variable specifies the ID of an application in table DRMAPPL. If not supplied, the 
default requests to display all application IDs known to DRM. 


This parameter queries the current audit information for the application. 


This parameter requests information on files matching the supplied filetmpl, fstates, or all 
files. It follows the applid parameter and must be either all, filempl, or fstates. 


This parameter specifies the first character of the file name to be queried followed by as 
many characters in the name as desired to identify a single file or group of files. It refers 
to all files owned by the application whose names match this filename template. A $ is use 
to substitute any number of characters within the file template. 


This parameter specifies the files to be queried by providing a list of file states. This 
parameter follows the fil parameter and may contain any combination of the letters a, u, p, 
and r, where: 


a is the active file to which the application is writing 
u indicates the file is closed and not processed 

p inidcates the filw is processed 

r this file may not be deleted. 
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D-768 DRM level commands 
info (continued) 


info command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter queries the rotate information for the specified application. 


This parameter requests information on all volumes. It directly follows the applid parametdr. 


This parameter identifies a specific volume to query. It follows the vol parameter unless tlle 
all parameter is used. It may be either a volume name or volume number from table 
DRMPOOL. 


Qualifications 
None 


Examples 
The following table provides examples of the info command. 


Examples of the info command 


Example Task, response, and explanation 


info occ all 


Task: Dispaly information for registration, audit, volume, file, and rotate 
for the application OCC. 


Response: 

Registration Information: 
Application ID OCC 
Application status. Active 
Node FPO 
Date and time of last registration 

90/10/17 09:32 
Number of registrations 

1 
Requested fixed or variable 
blocks Fixed 
Requested block size.2048 B 
Requested to allow 

CLOSTATE = PNO 


(continued) 
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DRM level commands D-769 
info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 


(response continued) 


SPACE Records written last audit interval 23168 
AUDIT Avg records per hour 
139008 
Avg volume space used per minute 290 KB/min 
Avg volume space used per hour 17400 KB/min 
Last audit interval 00:10:00 
Begin of interval 14:10:00 
End of interval 14:20:00 
Next scheduled audit time 14:30:00 
Last manual audit 90/10/17 10:38:00 
VOLUME Number of volumes allocated9 
TROUBLE INERROR: 2 6 
FULLU: 3 4 


InSv Total space 1200 MB 

POOL Free space 1120 MB; 93% 

SPACE Active space (A files) 5 MB; 
Unprocessed space (U files) 52 MB; 
Processed space (P files 2 MB; 

Removed space (R files) O MB; 
Non-usable space (Non-DRM) 0 MB; 
Available recording space (free + P)1142 MB; 95% 


FILES Number of files 74 
Active files 1 
Unprocessed files 25 
Processed files 48 
Removed files 0 


ROTATE Next scheduled ROTATE (date and time).. 90/10/17 
15:00:00 
Volume chosen for next file 1 
Volumes available (OK): 0 5 7 
Last ROTATE occurred (date and time)..90/10/17 14:00:00 
Cause of last ROTATE Schedule 
State assigned to files when closed U 


Explanation: The application’s pertinent registration information, and summary 
information for the various types of queries available: audit, volume, 
and rotate is displayed. 
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D-770 DRM level commands 
info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 
info ama audit — 


Task: Dispaly information for the AMA audit. 


Response: 
Audit operation performed 
Last manual audit 


Application Report: 
---ERROR CONDITIONS--- REQUESTS 
PEND NAME 
STATUS IBL SPA REQ FER VER SWE RIR ROT AUD 
OCC ACTIVE 
0 0 0 1 Oo 0 0 


InSv P space recovered during audit.O MB 
POOL Volume chosen for next file....1 
SPACE Total space 

Free space 

Active space (A files) 
Unprocessed space (U files) 
Processed space (P files).... 
Removed space (R files) 
Non-usabl (Non-DRM) 
Available recording space (free + P)1142 MB 
Schedule: 


AUDIT LAST AUDIT NEXT AUDIT 
AUDIT TYPE INTERVAL BEGIN END TIME 
SPACE 00:10:00 14:27:00/14:30:00 14:40:00 
VOLUME 01:00:00 13:58:00/14:00:00 15:00:00 
APPLICATION 00:10:00 14:30:00/14:30:00 14:40:00 
DRMFDIR 24:00:00 03:05:00/03:09:00 03:09:00 


Volume Report: 

SPACE VOLUME ERR FILE ERR 
V FR% AS US PS R% NS STATE SP AC FL IO FS IE CR OP WR CL RN 
092 1 3 4 O O INERROR 0 00 1 0 0 00 1 0 0 
194 0 6 0 0 0 OK 0 00 0 0 0 00 0 0 0 


V ERROR DESCRIPTION OPERATION 
0 Device unavailable Write to a file 


The ERROR counts were last reset on: 90/08/03 10:05:38 
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info (continued) 


Explanation: The request is for audit information only. The Application Report” 
section shows the status of the application and displays 
diagnosticcs informatin to help: 


diagnose the application status 
be aware of generated logs 
correlate error conditions 
monitor the integrity of the system 
provide diagnostics information for CSRs. 
The following are field descriptions for the response: 


NAME is the name of the application that was audited 


STATUS is the status of the applicatin after the audit. May 
be ACTIVE, IDLE, WAIT RTR (waiting for 
ready7-to-record), or INSANE. 

TBL is the number of error in tables DRMAPPL and 
DRMPOOL 

SPA is the number of volume space errors. sSum of 
SP field in volume report section. 

REQ is the number of DRM system requests ignored 
by the application. These requests are: 

- Ready T o Record 

- Time T o Rotate 

- Application Audit 


FER is the number of file operation errors. Sum of all 
fields under FILE ERR in the “Volume Report” 
section. 


VER is the number of volume errors. This is a 
superset of the FER field, as it also includes 
volume-specific errors related to allocation, 
access, directories, and space and info querires. 


is the number of software errors (SWERR) 
genertated while perfoming operations on behalf 
of the application. 


is the number of Ready To Record requests that 
have been sent to the application to which DRM 
is still expecting a response. 

is the number of Time To Rotate requests that 
have been sent to the application to which DRM 
is still expecting a response. 

is the number of Application Audit requests that 
have been sent to the application to which DRM 
is still expecting a response. 


The Volume Report section displays space, 
status, and diagnostics information regarding the 
applications volumes. 


The purpost for this information is the same as 
listed above for the Application Report section. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 
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info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 


SP is the number of errors related to volume space, 
which are: 
- Endoffile 
End of medium, that is, volume full 
ilsufficient space in free space map 
is the number of errors related to file access, 
which are: 
Could not find the spcified file 
File name is already in the directory 
Maximum number of open files is exceeded 
Access denied due to invompatible open instance 
IO is the number of errors related to volume 
input/output errors 
FS is the number of errors related to the file system, 
which are: 
Disk file organization unknown 
Checksum error 
Data corruption detected 
Invompatability between file system versions 


Can't get SOS resources, for example, store and pools 
Cannot get internal FTFS rewources 
Internal software error. SWERR issued. 


is the number of errors related to DRM interface 
to the file system, which are: 
Non-existent device 
Request is illegal/unsupported 
Request is okay but parameter suplied is not 
Somethinbg wrong with user supplied buffer 
Supplied pathname is incorrect 
File idnetifier is invlid 
FCBID is invalid 
Invalid volume type 
Invalid file type 
Access mode/ type is incorect, access denied 
Specified operation has not been inplemented 
Node is not registered 
Operation timed out 
Illegal directory operation 
Bad HD version; check SWERR 
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info (continued) 


Examples of the info command (continued) 
Example Task, response, and explanation 


The following fields are under the heading FILE ERR: 


CR create a new file 


OP open a file 

WR write to a file 

CL close a file 
rename a file 
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info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 


info ama rot J 
Task: Dispaly information for the AMA rotation. 


Response: 
Next scheduled ROTATE (date and time) 90/10/17 15:00 
Volume chosen for next file 
Volumes available (OK): 

0 2 5 
Last ROTATE occurred (date and time) ..90/10/17 14:00 
Cause of last ROTATE Schedule 


ROTATE COUNTS 
SCH MAN FSZ SPA 

0 0 
0 0 


2 
2 


The ROTATE counts were last reset on: 90/10/17 09:32 


Explanation: Information related to the application's ROTATE operations is 
displayed, including a count for each type, described below, since 
the last time they were reset with the RESET option. 


The ROTATE COUNT fields are described below, and they indicate 
the reasons why a ROTATE may be performed: 


SCH Scheduled 
MAN Manual, using this ROTATE command 


FZS Active file size reached MAXFDSIZ (field in 
DRMAPPL) 


SPA Active file exhausted the volume space. 
ERR Too many write errors. 
APP Requested by the recording application. 


The date and time when the ROTATE COUNTS were last reset is 
also displayed. 


info ama vol 0 J 
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info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 


Task: Display audit information for AMA volume 0. 


Response: 
VOLUME FPOODKOOOCCO 


V NODE SZ (M) RS N% STATE E FILES 


O FPO 600 92 1 3 4 0 0 OK 0 
FILE NAME BLOCKS BLKSZ T RECORDS FLSZ-KB 


AN9010171400050CC 2509 2048 F 40144 5013 0 OP 
UN9010171200030CC 8935 2048 F 142960 17870 A CL 
PN9010171000010CC 11059 2048 F 176944 22118 0 U PO 


Explanation: The command requests information on volume 1 from the OCC 
tuple in table DRMPOOL. The response consists of a volume 
section and a file section. The fields of each section are described 
below: 


VOLUME Volume name. 


V Volume number in DRMPOOL tuple (range 0 
to17) 


NODE Four character name of node where volume 
resides. 


SZ(M) Size of volume space in Mega bytes. 
FR% Percent of volume space that is free, or unused. 
A% Percent of space occupied by the Active file. 


U% Percent of space occupied by Unprocessed 
files. 


P% Percent of space occupied by Processed files. 
R% Percent of space occupied by Removed files. 


N% Percent of space that is non-usable by DRM. 
This space contains files that do not belong to 
DRM. 


STATE Volume state. May be one of the following: 


MNTing Mounting. The volume is in the process of 
mounting. Mounting includes setting ownership 
of the volume to DRM and adding the volume’s 
files to the DRM internal directory. This status 
does not change until these two functions are 
completed successfully. 


(continued) 
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D-776 DRM level commands 
info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 
(continued) 


SHUTDN Shutdown. The volume has been manually 
taken out of service. 

OK Ready for recording. The volume has free space 
and is available for the next Active file. 

INERROR Unavailable for recording due to errors. 
Craftperson must repair volume and return it to 
service with the RESETVOL command. 

FULLA Full, but available for recording. The volume has 
no free space, but has P (processed) files, 
which may be deleted if space becomes critical. 

FULLU Full, and unavailable for recording. The volume 
has no free space nor P (processed) files. 
External intervention is required, by a 
craftperson or polling application, to return the 
volume to either OK or FULLA. 

E Number of file operation errors counted on this 

volume since it was last put into service, or since the error 

counts were reset by way of the AUDIT command. 

FILES Number of files this volume contains. The File 

Section of the response consists of a file directory for the 

volume. The following information is displayed for each file. 

FILE Name of the file. 

BLOCKS Number of blocks written to the file. 

BLKSZ Size of blocks in bytes. 

T Type of blocks in the file. May be: 

- V variable block format 

- F fixed block format) 

RECORDS Number of records written to the file. These are 
the application’s records contained in the blocks. 


FLSZ-KB Size of the file in Kbytes. 
E Number of file operation errors. 


V Volume on which this file resides. This is the 
volume number in DRMPOOL. 


Previous file state. May be any of the following: 
Active 

Unprocessed 

Processed 

Remove 


(continued) 
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info (continued) 


Examples of the info command (continued) 


Example Task, response, and explanation 
(continued) 


Note: This field is blank for Active files. 


R Reason that file was changed to current state. May be any 


of: 

- OP File opened by DRM 

- CL File closed by DRM 

- PO Polling application requested the change 


MN (Manual request by way of RENAME command) 
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info (continued) 


Responses 


The following table provides explanations of the responses to the info 
command. 


Responses for the info command 


MAP output Meaning and action 


OPERATION FAILED. inter-nod 


connection is down. 


Meaning: The command could not be sent to tne FP because the inter-node 
connection was down. 


Action: RTS the FP. The FP must be stable before the inter-node connections 
can be re-established. 


The DRM system automatically re-establishes the connections. 


OPERATION FAILED. OCC has no files of th 


requested type. 
Meaning: One of the following commands was entered: 
info occ filetmpl all- 


info occ fstate all- 


and no files exist to satisfy the request. If at least one file in one of the 
requested file states or template exists, that file’s information is 
displayed, and this response does not appear. 


Action: None 


OPERATION FAILED. Software error occurred while sending message. A 
software error log has been generated. 


Meaning: The command could not be sent to the FP because the DRM system 
found a software error. 


Action: Retain the software error log for reference when consulting the DRM 


software maintenance personnel. 


A warm restart may be required to clear up the problem if it persists. 
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info (continued) 


Responses for the info command (continued) 
MAP output Meaning and action 
OPERATION FAILED. The requested volume is not allocated. 


Meaning: The DRMPOOL tuple for OCC does not have the volumes you 
requested. 


Action: Volumes may be allocated for the application by way of the mount 
command. 


OPERATION FAILED. There are no volumes allocated to this stream. 
Meaning: The DRMPOOL tuple for OCC is empty. 


Action: Volumes may be allocated for the application by way of the mount 
command. 


Press <CR> to continue, or enter QUIT: 
Meaning: More responses are expected from the FP. 


The DRM system on the FP is not finished responding to the command. 
The DRM Cl is waiting for additional responses from the FP. 


None 
Request aborted! 


Meaning: The command was aborted and never was sent to the FP. This occurs 
only in the following instance: 


“Press <CR> to continue, or enter QUIT:’ 


prompt appears before the command is sent to the FP, and you enter 
QUIT. 


Action: None 


>== Request sent ==> (Please wait...) 


Meaning: The command was successfully sent to the FP for processing. 


Action: None 
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info (continued) 


Responses for the info command (continued) 
MAP output Meaning and action 
Response preempted! 


Meaning: The response was preempted, and no more responses will be displayed 
for the entered command. 


The response is preempted in one of two ways: 
1. No response was received. 


2. QUIT was entered at the prompt: ‘Press <CR> to continue, 
or enter QUIT:’ 


Action: None 
RESPONSE READY. 
Meaning: A response from the FP is ready to be displayed. 


Action: Press <CR> to display the response, or enter QUIT to abort the 
response. 


Sending request... 
Meaning: A command was successfully entered. 
Action: None 

System was busy. Try again. 


Meaning: The command could not be sent to the FP because the DRM system did 
not have enough resources available to process the request. 


Action: The command may be repeated until the DRM system no longer rejects 
it. 


297-1001-821 Standard 04.01 June 1999 


DRM level commands D-781 
info (end) 


Responses for the info command (continued) 


MAP output Meaning and action 


Valid DRM stream nanes: 
OCC 


OM 
JE 


Meaning: The applid variable is not supplied or is not valid. 


The response presents a list of all valid application IDs that may be used 
as the applid parameter. 


This is a list of the keys in table DRMAPPL. 


Action: None 
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monitor 


Function 


Use the monitor command to monitor an application’s current active file in 
real-time. 


monitor command parameters and variables 


Command Parameters and variables 


monitor applid 


Parameters 
and variables Description 


This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, all application IDs known to DRM (all the keys from table DRMAPPL) are 
displayed. 


Qualifications 
The use of this command is not dependent upon other datafill tables. 


Example 
The following table provides an example of the monitor command. 


Example of the monitor command 
Example Task, response, and explanation 
monitor occ. 


Task: Monitor OCC’s active file. 


Response: Monitoring OCC ACTN FPO VOL :FPO/DKOOFTFS1 
FILE NAME BLOCKS BLKSZ T RECORDS FLSZ-KB ER V# 
AN9202021955000CC 2509 2048 F 40144 5018 0 0 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-784 DRM level commands 


monitor (continued) 


Example of the monitor command (continued) 


Example Task, response, and explanation 


Explanation: 


The command indicates monitoring of OCC’s active file. The 
response is a real-time display of OCC’s active file information, 
updated once a second. 


ACTN is the stream’s Active Node from which the stream data is 
written to the file. None’ indicates that an old active file has been 
recovered but there is no active node because the stream has not 
yet registered on any DRM node and the file is not open. 


VOL is the global path of the volume containing the file. 

BLOCKS is the number of blocks of records written to the file. 

Tis the block type, that may be ’F’ (fixed) or ’V’ (variable). 
RECORDS is the number of records written to the file. If a *? is 
displayed, then it is an old active file that has been recovered from 


disk and the number of stream records in the file cannot be 
determined. 


FLSZ-KB is the actual size of the file in Kbytes. 


ER is the number of errors that have occurred while attempting to 
perform some operation on the file. 


V# is the volume reference number in the stream’s volume pool 
(DRMPOOL tuple). 
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monitor (end) 


Responses 
The following table provides explanations of the responses to the monitor 


command. 


Responses for the monitor command 


MAP output Meaning and action 


Monitoring OCC ACTN FPO VOL :FPO/DKOOFTFS1 
FILE NAME BLOCKS BLKSZ T RECORDS FLSZ-KB 
AN9202021955000CC 2509 2048 F 40144 5018 


Meaning: The response is a real-time display of OCC's active file information, 
updated once a second. 


ACTN is the stream's Active Node from which the stream data is written 
to the file. None’ indicates that an old active file has been recovered but 
there is no active node because the stream has not yet registered on 
any DRM node and the file is not open. 

VOL is the global path of the volume containing the file. 

BLOCKS is the number of blocks of records written to the file. 

T is the block type, that may be ’F’ (fixed) or 'V” (variable). 

RECORDS is the number of records written to the file. If a ’?’ is 
displayed, then it is an old active file that has been recovered from disk 
and the number of stream records in the file can not be determined. 
FLSZ-KB is the actual size of the file in Kbytes. 


ER is the number of errors that have occurred while attempting to 
perform some operation on the file. 


V# is the volume reference number in the stream's volume pool 
(DRMPOOL tuple). 


Action: None 


Monitoring OCC ACTN VOL 
FILE NAME BLOCKS BLKSZ T RECORDS FLSZ-KB ER Vit 
(no active file) 


Meaning: OCC does not have an active file. The response is a real-time display of 
OCC's active file information that is updated every 3 seconds. 


Action: Refer to the previous response. 
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mount 


Function 
Use the mount command to assign a recording volume to an application. 


mount command parameters and variables 


Command Parameters and variables 


applid volume node_nm 


Parameters 
and variables Description 


This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, all application IDs known to DRM (all the keys from table DRMAPPL) are 
displayed. This parameter specifies the application pool to which the volume is to 
be added. 


node_nm This parameter specifies the name of the file processor that contains, or will contaln, 
the specified volume. 


volume This parameter specifies the volume being assigned. The name may be up to 20 
characters long and may refer to a volume that doesn't yet exist. 


Qualifications 
The MOUNT command triggers an AUDIT to be performed, thereby 
causing disk activity. It is best not to MOUNT volumes during peak busy 
hours. 


Example 
The following table provides an example of the mount command. 


Examples of the mount command 


Example Task, response, and explanation 

mount occ dk000cc1 fpo . 
Task: Mount application OCC, volume DK000CC1, for node FPO. 
Response: OPERATION SUCCESSful: 


Volume DK000CC1 has been 
allocated to OCCPOOL. 


Explanation: The command has mounted the specified application. 
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mount (end) 


Responses 


The following table provides explanations of the responses to the mount 
command. 


Responses for the mount command 


MAP output Meaning and action 


OPERATION SUCCESSFUL: Volume DK000CC1 has been allocated to OCCPOOL. 


Meaning: 


Action: 


The request is translated into an attempt to add the specified volume to 
the application’s pool in table DRMPOOL. In this case, the operation 
was successful because the volume name was 


-entered in the correct format 

-did not already exist in the pool 

-successfully sent to the appropriate FP node 

-available to be used by DRM; 

-able to be owned by DRM on the FP node (for exclusive write access). 


None 


Volume DKOOOCC1 is not available. 
Reason: Specified device does not exist 


Perform Mount operation? (YES/NO, or QUIT): 


Meaning: 


Action: 


The mount command failed because the volume: 


-is not mounted 

-is read-only 

-is owned by someone else 
-specified illegal or incorrect 
pathname or for other reasons that 
may prevent the volume from being 
used for the application’s recording 
data. 


Take corrective action to access volume. 


The status of the volume is changed by DRM. It is available for 
recording. 
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quit 
Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 


This parameter causes the system to display the Cl level from any MAP level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrnarhe 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 


number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DRM level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DRM level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DRM level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DRM level has returned to the MAPCI level. 


Responses 


The following table provides explanations of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DRM level menu with a menu that is two or more MAP levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DRM level commands D-791 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DRM level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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rename 


Function 
Use the rename command to rename a file by changing the file’s state. A 
file’s state is denoted by the first character of its name, either 
A (active), U (unprocessed), P (processed), or R (removed). This command 
allows the following file state transitions: 


e U->P,R 
e P->U,R 
e R->U,P 


rename command parameters and variables 


Command Parameters and variables 


rename applid filetmple newstate 


Parameters 
and variables Description 


applid This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, the default is a request to display all application IDs known to DRM (all 
the keys from table DRMAPPL). 


filetmple This variable is required if an application ID is supplied. The file name template mhy 
consist of the first character of a file name followed by any number of characters 
that sufficiently identifies one or more files. It must begin with U, PR or $. The $ 
may be used at the beginning or middle of a file name template to represent a single 
character, or at the end to represent a string of characters. If the template is not a 
complete file name, a list of matched names are displayed; one of the names ma 

be selected for the operation. 


newstate This variable specifies the new state for the file. May be U, P, or R. The letter is 
the first character of the new file name. This parameter must always follow 
filetmple. 


Qualifications 
The rename command is qualified by the following exceptions, restrictions, 
and limitations: 


e The use of this command is not dependent upon other datafill tables. 


e Active files may not be renamed. 
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rename (continued) 


Example 
The following table provides an example of the rename command. 


Examples of the rename command 


Example Task, response, and explanation 


rename occ an90102613r — 


Task: Rename the specified file. 


Response: OPERATION FAILED: No files match this template 
in OCC: AN90102613 


Explanation: OCC has no files matching this filename template. This is also the 
response format when a specific file can not be found (when the 
entire filename is supplied). 


Responses 


The following table provides explanations of the responses to the rename 
command. 


Responses for the rename command 
MAP output Meaning and action 


Incorrect <filetmpl> parameter: AN901026 
The parameter must begin with either U, P, or R. 


Meaning: A <filetmpl> parameter starting with a character other than U, P, or R 
was entered. 
Only unprocessed, processed, and removed files may be renamed. 


ACTIVE files are always open, and they are automatically renamed by 
the system when they are closed to a name that is determined by field 
CLOSTATE, in table DRMAPPL. 


Field CLOSTATE may be set in table DRMAPPL to cause ACTIVE files 
to be named either U, P, or R when they are closed. A ROTATE causes 
the ACTIVE file to be closed and renamed accordingly. 
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rename (continued) 


Responses for the rename command (continued) 


MAP output Meaning and action 


OPERATION FAILED: No files match this template in OCC: AN90102613 


Meaning: OCC has no files matching this filename template. This is also the 


response format when a specific file can not be found (when the entire 
filename is supplied). 


Action: Aless specific template may be used in order to display a list of 
filenames from which to chose. In this case: 


>RENAME OCC U$901026 R 


would display all files created on 901026 that are in the U (unprocessed) 
state, and may or may not have been copied to DAT. 


OPERATION FAILED: While attempting to rename file: UN9010262000430CC 
to RN9010262000430CC the following file system error occurred: 
Input/Output error 


Meaning: The rename operation failed due to a file system error. 


Action: None 


Caution: This response should be discerned as a warning that the file 
system is experiencing serious difficulties. The file system error 


message is displayed for diagnostics purposes to help correct the 
problem. 


OPERATION SUCCESSFUL: RB9010261624380CC has been renamed: 
PB9010261624380CC 


Meaning: The file’s name is changed on disk and the file's state is changed from R 
(removed) to P (processed) in the system 


Action: None 
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D-796 DRM level commands 
rename (end) 


Responses for the rename command (continued) 


MAP output Meaning and action 


These files match the supplied filename template: 


UB9010260000380CC 
. UN9010260400390CC 
UN9010260800400CC 
UB9010261200410CC 
UN9010261600420CC 
UB9010262000430CC 


Select a file number (1 TO 6, or QUIT): 


Meaning: A request is received to change an U (unprocessed) file, that was 
created on 901026, to an R (removed) file. If only one U file had been 
created on that date the file name would have been changed. Six files 
match the request, therefore, a list of the file names is displayed so one 
may be selected to rename. 


The numbers to the left of the file names are used to select the one to be 
renamed. 


Action: Enter the number of the file to be renamed, or QUIT to terminate the 
request. 
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DRM level commands D-797 
reset 


Function 


Use the reset command to reset the error and rotate counters maintained by 
DRM per application and per node. 


reset command parameters and variables 


Command Parameters and variables 


applid err actn 
rot all 


node_nm 


Parameters 
and variables Description 


This is a system default when an optional <node name> parameter is not supplied. 
It may replace <node name> parameter to refer to the application’s active node. 


The active node is where the application delivers its data to DRM for recording and 
is not necessarily the node containing the application’s active file. 


This parameter specifies that the counters on all nodes where the application has 
registered are to be reset to 0. 


This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, all application IDs know to DRM (all the keys from table DRMAPPL) will 
be displayed. 


This parameter specifies that only the error counters are to be reset to 0. 


This variable specifies the node where the counters are to be reset to 0. 


This parameter specifies that only the rotate counters are to be reset to 0. 


Qualifications 


The reset command is qualified by the following exceptions, restrictions, 
and limitations: 


e The use of this command is not dependent upon other datafill tables. 


e The use of this command causes the specified counters to be reset to 0, 
resulting in the loss of counter values. 
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D-798 DRM level commands 
reset (continued) 


Example 
The following table provides an example of the reset command. 


Example of the reset command 


Example Task, response, and explanation 
reset occ rot all — 


Task: Reset OCC’s rotate counters on all FPs and the CM. 


Response: RESET OCC ROT completed on CM 
RESET OCC ROT completed on FPO 
RESET OCC ROT completed on FP1 


Explanation: The operation was successfully completed on the three nodes 
listed. 


Responses 


The following table provides explanations of the responses to the reset 
command. 


Responses for the reset command 


MAP output Meaning and action 


Issuing this command causes the specified counters to be reset to 0, 
resulting in the loss of the counter values. 


Meaning: 
Action: None 


OPERATION SUCCESSFUL: 
RESET OCC ERR completed on FPO 


Meaning: The resetting of OCC’s error counters on FPO was successfully 
completed. 


Action: None 
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DRM level commands D-799 
reset (end) 


Responses for the reset command (continued) 


MAP output Meaning and action 


OPERATION SUCCESSFUL: 
RESET OCC ROT completed on FP1 


Meaning: The resetting of OCC’s rotate counters on FP was successfully 
completed. 


Action: None 


RESET OCC ROT completed on CM 
RESET OCC ROT completed on FPO 
RESET OCC ROT completed on FP1 


Meaning: The resetting of OCC’s rotate counters on all FPs and the CM was 
successfully completed on the three nodes listed. 


Action: None 
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DRM level commands D-801 
rotate 


Function 
Use the rotate command to open a new recording file and close the old one. 


rotate command parameters and variables 


Command Parameters and variables 


applid node_nm volume 


Parameters 
and variables Description 


applid This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, all application IDs known to DRM (all the keys from table DRMAPPL) are 
displayed. 


node_nm This variable specifies the name of a node containing volumes from the 
application's pool. 


volume This variable specifies the volume to which to rotate. lt may be either a volume 
name of volume number from table DRMPOOL. 


Qualifications 


The rotate command is qualified by the following exceptions, restrictions, 
and limitations: 


e Use of this command is not dependent upon other datafill tables 


e Execution of this command may interfere with the recording throughput 
of the application if the target node has no volumes available for 
recording. DRM will attempt to perform the rotate to the target node and 
volume specified in the command, and may perform several volume 
audits on the target node to accomplish the rotate. If the rotate is to a 
volume on the current active node and the rotate fails, DRM will attempt 
to continue using the old active file. But if the application chooses a 
new active node and the rotate fails, DRM must locate the next best 
volume for the new active file. The recovery from a rotate failure may 
be costly in time and hence there exists the potential for an extended 
pause in the recording of the application’s data. 


WARNING 
Briefly state the reason for the warning 
Execution of this command may interfere with the 


recording throughput of the application if the target node 
has no volumes available for recording. 
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D-802 DRM level commands 
rotate (continued) 


Example 


The following table provides an example of the rotate command. 


Example of the rotate command 


Example Task, response, and explanation 


rotate occ fp0 — 


Task: 


Response: 


Explanation: 


Download the specified node/volume parameters to all FPs and the 
CM 


Downloading parameters.... 

Done. 

Sending Request... (Please wait)... 
>== Request sent +==> FPO 


Waiting for OCC response... 
(30 sec timeout...) 


The specified node/volume parameters are downloaded to all FPs 
and the CM. Then the actual rotate request is sent to the current 
active node, where the rotate request is passed on to the OCC 
software. If the OCC software responds within 30 seconds and the 
rotate command succeeds in creating a new active file, the 
MONITOR level is entered to display the status of the new active 
file. Refer to the monitor command for examples of the display. 
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DRM level commands D-803 
rotate (end) 


Responses 


The following table provides explanations of the responses to the rotate 
command. 


Responses for the rotate command 


MAP output Meaning and action 


Downloading parameters.... 

Done. 

Sending Request... (Please wait)... 
>== Request sent +==> FPO 


Waiting for OCC response... 
(30 sec timeout...) 


Meaning: The specified node/volume parameters are downloaded to all FPs and 
the CM. Then the actual rotate request is sent to the current active 
node, where the rotate request is passed on to the OCC software. Ifthe 
OCC software responds within 30 seconds and the rotate command 
succeeds in creating a new active file, the MONITOR level is entered to 
display the status of the new active file. Refer to the monitor command 
for examples of the display. 


Action: Enter the monitor command to display the status of the new active file. 


OPERATION FAILED: 
Device Unavailable 


Meaning: The specified volume is not available. 


Action: Use the info command to query the application's current resources and 
volume status for choosing an alternate volume to rotate to, and to help 
diagnose the reason failure in more detail. 
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DRM level commands D-805 
tcopy 


Function 
Use the tcopy command to copy DRM files to 9 track tape. 


tcopy command parameters and variables 


Command Parameters and variables 
device_dr  applid filetmpl 


Parameters 
and variables Description 


applid This variable specifies the ID (key) of an application in table DRMAPPL. 


filetmpl This variable a required parameter if an application ID is supplied. The file name 
template may consist of the first character of a file name followed by any number 
of characters that sufficiently identifies one or more files. It must begin with U, P, 
Ror $. The $ may be used at the beginning or middle of a file name template to 
represent a single character, or at the end to represent a string of characters. Ifthe 
template is not a complete file name, a list of matched names are displayed; one 
of the names may be selected for the operation. 


device_dr This variable specifies the device drive and has a range of 0-15. 


Qualifications 
The use of this command is not dependent upon datafill values. 
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D-806 DRM level commands 
tcopy (continued) 


Example 
The following table provides an example of the tcopy command. 


Example of the tcopy command 


Example Task, response, and explanation 


tcopy 0 occ uJ 


Task: 


Response: These files match the supplied filename template: 
UN9205062055000cc 2 UN925080300000cc 
N9205080444000cc 4 UN9205080453000cc 
N9205080833000cc N9205082132000cc 
N9205082144000cc N9205082246000cc 
JN9205082340000cc N9205082351000cc 
N9205082354000cc N9205090006000cc 
N9205090059000cc N9205090106000cc 
JN9205090109000cc N9205090532000cc 


U 
U 
U 
U 
U 
U 


Explanation: 


Responses 
The following table provides explanations of the responses to the tcopy 


command. 


Responses for the tcopy command 


MAP output Meaning and action 


WRITING File UN9205062055000CC 
File written. 


Meaning: The first line of the pair of messages is written when the writing begins. 
The second line is written when the writing has completed. 


Action: None 


Formatting tape...Format complete. 


Meaning: DRM is formatting the tape for DRM use. The format completed 
successfully. 


Action: None 
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DRM level commands D-807 
tcopy (continued) 


Responses for the tcopy command (continued) 


MAP output Meaning and action 


OPERATION FAILED: Please make sure that a tape is physically mounted. 


Meaning: A tape is not physically present in the tape drive. 

Action: Puta tape in the drive and reissue the command. 
OPERATION FAILED: tape is WRITE PROTECTED. 

Meaning: The tape has write protection enabled. 

Action: Remove the write protection, remount the tape, and proceed. 


OPERATION FAILED: Tape Drive is in use. 
Meaning: The tape drive is already in use by some other process. 


Only one process at a time can own the tape drive. When an attempt is 
made to open the tape but another process already has a tape opened 
in this drive, the operation cannot proceed. 


Action: Wait until the tape drive is free. 
WRITING File UN9010262000430CC ...Writing failed. 


Meaning: The tape does not have enough room to accommodate the file being 
written. 


Action: Field MAXFDSIZ must be set to 64mb in table DRMAPPL to limit the 


size of the files if files are routinely copied to 9 track tape. The file may 
be copied to DAT tape instead. 


OPERATION FAILED. Copy of active file is not permitted. 


Meaning: You attempted to back up the active file 


Action: Wait until the next ROTATE (this may be forced manually), then copy the 
file to tape. 
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D-808 DRM level commands 
tcopy (continued) 


Responses for the tcopy command (continued) 


MAP output Meaning and action 


These files match the supplied filename template: 


UB9010260000380CC 
UN9010260400390CC 
. UN9010260800400CC 
. UB9010261200410CC 
UN9010261600420CC 
UB9010262000430CC 


Select a file number or enter QUIT: 


Meaning: You specified a filename template matching more than one filename. 


Action: Enter either the number of the filename to be written to tape or QUIT to 
abort the operation. 


OPERATION FAILED. No files match the specified template. 


Meaning: You specified a filename template that the system cannot find. 


Action: Reenter the command specifying a different filename template. If 
necessary, query the DRM filelist to see what files are present. 


OPERATION FAILED. Invalid application id specified. 
Meaning: You specified an invalid application ID. 


The application ID specified has no entry in DRMAPPL. The request 
cannot be processed 


Reenter the command specifying a different application id. If necessary, 
issue a tcopy command with no other parameters to see a list of valid 
application IDs. 


OPERATION FAILED DUE TO UNEXPECTED TAPE ERROR. 


Meaning: An unrecoverable error occurred with the tape or tape drive. The lOC 
file system should generate logs to document the condition. 


Some sort of error has occurred with the tape or the tape drive. DRM is 
unable to circumvent the problem so the request cannot be completed 


Action: Check the system log to discover the nature of the problem. 
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DRM level commands D-809 
tcopy (continued) 


Responses for the tcopy command (continued) 


MAP output Meaning and action 


OPERATION FAILED: While attempting to access file: UN9010260400390CC, 
the following file system error occurred: Input/Output error 


Meaning: The 9 track tape operation fails due to a file system error. 


Action: None 


Warning: This response should be discerned as a warning that the file 
system is experiencing serious difficulties. The file system error 
message is displayed for diagnostics purposes to help correct the 
problem. No user action is required. 


The tape just mounted is already labeled as a DRM tape. Do you wish to 
OVERWRITE it? (NO indicates APPEND.) 


Meaning: The tape just mounted for file backup has previously been used by 
DRM. Thus, it is likely there are billing files already on the tape. Since 
this operation poses the possibility of loss of billing data, the operator is 
queried as to whether the files on the tape should be overwritten or if 
new data files should be appended. The option to quit this operation is 
provided in case of operator error. 


Select: 

YES -- OVERWRITE the tape 
NO -- APPEND to the tape 
QUIT -- ABORT this operation 


OPERATION FAILED: Demount operation failed. 
Meaning: The tape operation was aborted by either the system or the user after 
the tape was mounted but before any file had been written. An error 


occurred demounting the device. 


Action: Examine the log for possible hardware problems. 


The tape just mounted contains the label xxxxxx. Do you want to reformat 
this tape for DRM use? 


Meaning: A tape has been mounted that has previously been used by some other 
entity. Important data may be stored on the tape, so DRM prompts for 
verification before reformatting the tape. 


Action: ENTER: 
YES -- DRM reformats tape 
NO -- DRM demounts tape drive 
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D-810 DRM level commands 

tcopy (end) 
Responses for the tcopy command (continued) 
MAP output Meaning and action 


OPERATION FAILED: Could not allocate buffer for copying. 


Meaning: DRM was unable to allocate buffer space for copying the disk file. 
Action: Wait and try again. 


OPERATION FAILED: Could not open disk file for reading. File not Found. 


Meaning: DRM was unable to open the disk file for reading of data for file backup. 
The actual error printed depends upon the error that occurred. 


Action: Examine error message and system status. Perhaps a disk drive was 
busied during the operation. 


v297-1001-821 Standard 04.01 June 1999 


DRM level commands D-811 
view 


Function 
Use the view command to get ahexadecimal dump of a given file. 


view command parameters and variables 


Command Parameters and variables 
applid filetmpl charcode block_num  view_num 


Parameters 
and variables Description 


applid This variable specifies the ID (key) of an application in table DRMAPPL. If not 
supplied, the default is a request to display all application IDs known to DRM (all 
the keys from table DRMAPPL). 


block_num This variable is used to specify the location within the file to start viewing. A space 
must be entered prior to this variable. The upper bound for this variable is specifid 
to the file, and will be the total number of blocks in the file. The info fil filetmpl 
command provides this information. 


charcode This variable specifies the character code set to use in the character translation of 
the hex data. 


filetmpl This is a required variable if an application ID is supplied. The file name template 
may consist of the first character of a file name followed by any number of 
characters that sufficiently identifies one or more files. lt must begin with U, P, R 
or $. The $ may be used at the beginning or middle of a file name template to 
represent a single character, or at the end to represent a string of characters. 


If the template is not a complete file name, a list of matched names is displayed; 
one of the names may be selected for the operation. 


view_num This variable specifies the a number to be assigned to the view. 


Qualifications 
None 
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D-812 DRM level commands 
view (continued) 


Examples 
The following table provides examples of the view command. 


Examples of the view command 


Example Task, response, and explanation 
view occ un921216002600 as 1. 


Task: Produce a hexadecimal dump of file un921216002600. 


Response: 
Block 1: 


0000 |4153 4349 492C ASCII, block 
1: 
0010 |3031 3233 3435 
0123456789ABCDEF 

0000 0000 0000 


6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 qrstuvwxyz. 
0050 |4142 4344 4546 
abcdefghijklmnop 
0060 |5152 5354 5556 qrstuvwxuz. 
0070 |456E 6420 6F66 End of block 
1; 


Block 2: 


0000 |4153 4349 492C ASCII, block 
25 
0010 |3031 3233 3435 
0123456789ABCDEF 

0000 0000 0000 


6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 qrstuvwxyz. 
0050 |4142 4344 4546 
abcdefhijklmnop 

0060 |5152 5354 5556 qrstuvwxuz 
0070 |456E 6420 6F66 End of block 
2. 
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DRM level commands D-813 
view (continued) 


Examples of the view command (continued) 


Example Task, response, and explanation 


Explanation: 


view ama filetmpl eb 2894 J 


Task: 


Response: 


Explanation: 


This is an example of the response when the filetmpl is a valid and 
complete file name for a file that contains two 128 byte blocks 
belonging to the OCC recording stream. The data in the blocks 
contains ASCII characters. 


The numbers in the left-hand column are the hex offsets of the first 
word in each row of the block. 


The display on the right-hand side of the hex dump contains the 
character translation of the dump. Specify whether the file contains 
ASCII or EBCDIC so that the correct translation may be done. 


The data is displayed in the same order as it was read from the file; 
it reads left-to-right, and top-down. It is displayed in rows of 8 
hexadecimal words for easier legibility. No byte-swapping is done. 


Block 2894: 
C5C2 C3C4 C9C3 


FOF] F2F3 F4F5 F6F7 F8F9 C1C2 C3C4 C5C6 
012345678 9ABCDEF 
0000 0000 0000 0000 0000 0000 0000 0000 


8182 8384 8586 8788 8991 9293 9495 9697 
abcdefghijklmnop 

0040 |9899 A2A3 A4A5 A6A7 ABA9 4B40 4040 4040 
qrstupwxyz. 

0050 |C1C2 C3C4 C5C6 C7C8 C9D1 D2D3 D4D5 D6D7 
ABCDEFGHIJKLMNOP 

0060 |D8D9 E2E3 E4E5 E6E7 E8E9 4B40 4040 4040 
ORSTUVWXYZ. 

0070 |C595 8440 9686 4082 9392 40F2 F8F9 F44B 
End of blk 2894. 


This is an example of the response when the filetmpl is a valid and 
complete file name for a file that contains at least 2894 128 byte 
blocks belonging to the OCC recording stream. The user specifies 
that the block contains EBCDIC characters, and that only block 
2894 should be displayed. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-814 DRM level commands 
view (continued) 


Responses 


The following table provides explanations of the responses to the view 
command. 


Responses for the view command 


MAP output Meaning and action 


Block 1: 


0000 |4153 4349 492C 
block 1: 

0010 |3031 3233 3435 
012345678 9ABCDEF 
0000 0000 0000 


6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 
qrstupwxyz. 
0050 |4142 4344 4546 
abcdefghijklmnop 
0060 |5152 5354 5556 
qrstivwxuz. 

0070 |456E 6420 6F66 End of block 1. 


Block 2: 


0000 |4153 4349 492C 
block 2: 

0010 |3031 3233 3435 
012345678 9ABCDEF 
0000 0000 0000 


6162 6364 6566 
abcdefghijklmnop 
0040 |7172 7374 7576 
qrstupwxyz. 
0050 |4142 4344 4546 
abcdefhijklmnop 
0060 |5152 5354 5556 
qrstivwxuz 

0070 |456E 6420 6F66 End of block 2. 
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DRM level commands D-815 
view (continued) 


Responses for the view command (continued) 
MAP output Meaning and action 
Meaning: The filetmpl is a valid and complete file name for a file that contains two 


128 byte blocks belonging to the OCC recording stream. The data in the 
blocks contains ASCII characters. 


The numbers in the left-hand column are the hex offsets of the first word 
in each row of the block. 


The display on the right-hand side of the hex dump contains the 
character translation of the dump. Specify whether the file contains 
ASCII or EBCDIC so that the correct translation may be done. 


The data is displayed in the same order as it was read from the file; it 
reads left-to-right, and top-down. It is displayed in rows of 8 
hexadecimal words for easier legibility. No byte-swapping is done. 


Action: None 
Block 2894: 


0000 |C5C2 C3C4 C9C3 6B40 9240 F2F8 EBCDIC, 
blk 2894 

0010 |FOF1 F2F3 F4F5 F6F7 c1c2 C3C4 
0123456789ABCDEF 

0000 0000 0000 0000 0000 0000 


8182 8384 8586 8788 9293 9495 
abcdefghijklmnop 

0040 |9899 A2A3 A4A5 A6A7 4B40 4040 
qrstupwxyz. 

0050 |C1C2 C3C4 C5C6 C7C8 D2D3 D4D5 
ABCDEFGHIJKLMNOP 

0060 |D8D9 E2E3 E4E5 E6E7 4B40 4040 
ORSTUVWXYZ. 

0070 |C595 8440 9686 4082 40F2 F8F9 
End of blk 2894. 


Meaning: The filetmpl is a valid and complete file name for a file that contains at 
least 2894 128 byte blocks belonging to the OCC recording stream. The 
user specifies that the block contains EBCDIC characters, and that only 
block 2894 should be displayed. 


Action: None 
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D-816 DRM level commands 
view (continued) 


Responses for the view command (continued) 


MAP output Meaning and action 


These files match the supplied filename template: 


UB9010260000380CC 
UB9010260400390CC 
UB9010260800400CC 
UN9010261200410CC 
UB9010261600420CC 
UN9010262000430CC 


Select a file number (1 TO 6, or QUIT): 


Meaning: The filename template matches six files owned by OCC. Note the 
wildcard character (‘$’) usage. 


The numbers to the left of the file names are used to select the file to be 
viewed. 


Action: Enter the number of the file to be viewed, or QUIT to terminate the 
request. 


OPERATION FAILED. No files match this template in OCC: UB90102613 
Meaning: OCC has no files matching this filename template. 


This is also the response format when a specific file cannot be found 
(when the entire filename is supplied). 


Action: None 


Incorrect <filetmpl> parameter: XB901026. 
The parameter must begin with either A, U, P, R, or $, and must be < or = 
18 characters long. 


Meaning: You entered a filetmpl variable starting with a character other than A, U, 
P, R, or $. 


Action: Reenter a variable with a valid character. 
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DRM level commands D-817 
view (end) 


Responses for the view command (continued) 


MAP output Meaning and action 


OPERATION FAILED. While attempting to view file: UN9010262000430CC the 
following file system error occurred: Input/Output error 


Meaning: The VIEW operation fails due to a file system error. 


A file system error occurred while trying to read the file. This response 
is displayed and the command is terminated. 


None 


Warning: Consider this a warning that the file system is experiencing 


serious difficulties. The file system error message is displayed for 
diagnostics purposes to help correct the problem. 


OPERATION FAILED. Block 18587 is out of range. 


File UN9010262000430CC 
has 15902 blocks. 


Meaning: The file only has 15902 blocks. 
This input error may only be discovered when the command is 
processed by the DRM system on the FP. This response is displayed 


and the command is terminated. 


Action: None 
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D-819 


DTC level commands 


Use the DTC level of the MAP to perform maintenance functions for a 
digital trunk controller (DTC). 


Accessing the DTC level 


To access the DTC level, enter the following from the CI (Command 
Interpreter) level: 


mapci:mtc;post dtc dic_no — 


where 


dic_no is the number of the DTC to be posted 


DTC commands 


The commands available at the DTC MAP level are described in this 
chapter. They are arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DTC commands (continued) 


Command 


abtk 

bsy 

disp 

listset 
loadnotest 
loadpm 
next 


offl 


perform 


pmreset 
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DTC commands (continued) 


Command 


post 
querypm 
quit 


recover 


warmswact 


xpmlogs 


xpmreload 


xpmreset 
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DTC level commands D-821 


DTC menu 


The following figure shows the DTC menu and status display. The insert 
with hidden commands is not a visible part of the menu display. 


CM MS IOD Net PM ccs LNS Trks Ext APPL 
4SysB 
M 
DIE SysB ManB offl CBsy ISTb InSv 
0 Quit PM 4 0 10 3 3 130 
2 Post DTC 0 0 0 1 T 40 
3 ListSet 
4 DTC 0 ISTb ‚Links OOS: Cside O ; Pside 0 
5 Trnsl_ Unit 0: Act ISTb 
6 Tst_ Unit 1: InAct ManB 
7 Bsy_ 
8 RIS_ 
9 Offl 
10 LoadPM_ 
11 Disp_ 
12 Next_ 
he Hidden commands 
14 QueryPM_ 
15 abtk warmswact 
16 loadnotest xpmlogs 
17 Perform pmreset xpmreload 
18 recover xpmreset 


DTC status codes 
The following table describes the status codes for the DTC status display. 


Status codes DTC menu status display 
Code Meaning Description 
State PM states (see Notes 1: and 2:) 
CBsy Central Side PMs connected to the network are unable to communicate with the CC 


Busy because either the network or the links used to carry messages 
between the PM and the P-side of the network are unavailable. 


A PM that is connected to the Network by one or more PMs are 
out-of-service because the C-side ofthe PM or the links of aPM are 
unavailable. 


At the STC level, the ST is available in a pool for CCS7 use, but is not 
connected to a transmission link. 
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Status codes DTC menu status display (continued) 
Code Meaning Description 


InSv In Service PMs are in service and available to support any intended process, for 
example, call processing. 


ISTb In-Service PMs are still in service but flagged by system maintenance because 
Trouble either: 


a minor error condition occurred 
the PM failed a REX or minor audit test 


the load is not listed in the corresponding data table 


Call processing service is not affected. 


Manual Busy PMs are manually removed from service by command bsy to allow 
testing and other manual maintenance action. 


Not Equipped At the STC level, the ST discrimination number (STNO) is not listed in 
Table STINV. 


Offline PMs are temporarily made out-of-service. 
System Busy PMs are automatically removed from service by system maintenance. 


Note 1: When an XPM status is displayed as manually busy (ManB), off-line (Offl), or unequipped (UNEQUIP), the activity 
display (Active--Act, or Inactive--Inact) remains blank. When the activity state is not displayed, the command strings rts 
inactive, loadpm inactive, and SwAct are not valid. 

Note 2: When an XPM status is displayed as in service (InSv), in-service trouble (ISTb), C-side busy (CBsy), or system 
busy (SysB), the activity (Act or Inact) is also displayed. 
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DTC level commands D-823 
abtk 


Function 


Use the abtk command to abort all active maintenance actions on a posted 
DTC. The state of the DTC remains the same. 


abtk command parameters and variables 


Command Parameters and variables 


There are no parameters or variables. 


Qualifications 
The abtk command is qualified by the following: 


e Use the abtk command when using the loadpm command to cancel the 
entry of a wrong /_name parameter, or when the unit is executing 
maintenance processes. 


e The loadpm command without the nowait parameter “locks” the terminal 
keyboard so that other commands cannot be entered until the process is 
completed. The abtk command unlocks the keyboard by cancelling the 
loading. 


Example 


The following table provides an example of the abtk command. 


Example of the abtk command (continued) 


Example Task, response, and explanation 


Task: Stop all current maintenance action on the posted DTC 


Response: <display changes> 


Explanation: All current maintenance procedures halted. 
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D-824 DTC level commands 
abtk (end) 


Responses 
The following table provides explanations of the responses to the abtk 


command. 


Responses for the abtk command 
MAP output Meaning and action 
<display changes> 
Meaning: The following line, for example, is deleted from the loadpm display: 
LoadPM UNIT 1 /Loading 200 
The abtk command deletes any part ofthe display associated with a 
previous active maintenance command such as: swact, tst, bsy, rts, offl, 


loadpm. It returns units to previous states. 


The displays for the following commands are unaffected: trnsl, disp, 
next, querypm. 


The post command is not cancelled and the previous DTC posting is 
unaffected. 


ABORTING MAINTENANCE ON THIS PM WILL AFFECT 
MAINTENANCE ON OTHER PMS. 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: Aborting a broadcast loading affects the loading of all PMs in the parallel 
loading of the posted set. 


Action: Entering YES aborts the loading. Groups of XPMs that have already 
been loaded remain loaded, while the group that has loading in progress 
retains the current load. Entering NO allows the maintenance action to 
proceed. 
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DTC levelcommands D-825 
bsy 
Function 


Use the bsy command to change the state of one or all posted digital trunk 
controllers (DTC) to ManB. The bsy command can be applied to one or all 
units, the whole DTC or all DTCs, or one P-side link of one DTC of the 
posted set. 


bsy command parameters and variables 


Command Parameters and variables 


pm wait noforce posted 
unit unit_no nowait force all 
active 

inactive 

link ps_link 


Parameters 
and variables Description 


This parameter busies one or all of the units in the active state. 


This parameter simultaneously busies all of the specified unit(s) or XPMs of the 
same node type as the XPM in the current position of the posted set. 


Note: With the all parameter, greater numbers of XPMs take longer times to 
complete busying. Other maintenance activities must wait until the bsy 
command has completed executing. 


This parameter forces the busying to occur even though maintenance actions are 
already in progress (for example, while DTC is undergoing REX testing). 


This parameter busies one or all of the units in the inactive state. 


This parameter applies the bsy command to a specified P-side link between the 
posted DTC and one of its associated line concentrating modules (LCM). 


This default parameter, which is never entered, indicates that the bsy will not 
execute until any current maintenance action is completed because the force pa- 
rameter is not entered. 


This parameter allows other maintenance actions to occur before bsy is completed. 


pm This parameter busies all units of the posted DTC(s). 


posted This default parameter, which is never entered, indicates that only the currently 
posted DTC be made bsy because the all parameter is not entered. 
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D-826 DTC level commands 
bsy (continued) 


bsy command parameters and variables (continued) 


Parameters 
and variables 


ps_link 
unit 


unit_no 


wait 


Description 


This variable specifies which P-side link is to be made ManB. The range is 0-19. 


This parameter busies one or all units of the posted DTC(s). 


This variable specifies which unit of the posted DTC(s) is to be made ManB. The 
range is 0 or 1. 


This default parameter, which is never entered, indicates that additional commandp 
cannot be entered until the bsy command has completed because the nowait pa- 
rameter is not entered. 


Qualifications 


Examples 


None 


The following table provides examples of the bsy command. 


Examples of the bsy command 


Example 


bsy active 


Task, response, and explanation 


Task: Busy the posted DTC 
Response: OK 


Explanation:The posted DTC is posted. 


Task: Busy the active unit of the DTC. 


Response: A Warm SwAct will be performed 
please confirm (“YES”, “Y”, “NO”, OR “N”): 


Explanation:Typical response when active side of DTC is busied. 


297-1001-821 Standard 04.01 June 1999 


DTC level commands D-827 
bsy (continued) 
Responses 


The following table describes the meaning and significance of responses to 
the bsy command. 


Responses for the bsy command 
MAP output Meaning and action 
ALL OPTION NOT SUPPORTED FOR LINK PARAMETER 


Meaning: The all parameter does not apply to links because they must be busied 
one at a time. 


Action: Use the parameter link without the all parameter to busy a link. 
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D-828 DTC level commands 
bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


DTC 2 BSY refused by SwAct Controller 
Inactive unit has a history of: 
<history text> 
Inactive unit is reporting: 
<XPM text> 
To override the SwAct Controller, type 
SWACT FORCE, and then re-issue BSY command. 


Meaning: The bsy command has been refused by the SwAct controller because 
the resulting swat has been refused. This occurs only under the 
following conditions: 


Both units of the XPM are in-service. 


The BSY is executed on the active unit only, causing a warm SwAct 
to be attempted. 


The SwAct controller denies the SwAct request. 


When a SwAct is refused, the reason is indicated. The refusal reason text may 
include either <history text>, <XPM text>, or both, where: 


<history text> is one of the following: 

- IMC link failures 

- Message link failures 

- Parity audit failures 

- Superframe sync failures 

- Inactive unit was unable to keep activity last time 
- Dropping activity due to <autonomous drop reason> 
- PreSwAct query failure 

<XPM text> is one of the following: 

- Unit is jammed Inactive 

- Unit is in overload 

- Message link failure 

- Static data corruption 

- IMC link failure 

- PreSwAct difficulties 


Action: The bsy command may be reissued after a forced SwAct. 
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DTC level commands D-829 
bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


DTC 2 IS MANUAL BUSY 
NO ACTION TAKEN 


Meaning: The bsy command is applied to a PM that is already in the Manb state. 
Action: None 
DTC 2 MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTC cannot be busied because it is already undergoing 
maintenance action. 


Action: | When the all parameter is entered, the DTC is bypassed from the 
posted set of DTCs only for the duration of the busying. 


DTC nn UNIT u BSY PASSED 


Meaning: The specified DTC or unit is confirmed to be ManB, where nnn and u are 
the discrimination numbers. 


Action: None 
MTCE IN PROGRESS 
Meaning: The PM or unit cannot be busied while maintenance actions are already 
in progress. To override (and cancel) the actions, use the force 
parameter. 
Action: None 
NO ACTION TAKEN 
Meaning: NO is entered in response to a prompt and the command is aborted. 


Action: None 


NO PM POSTED 


Meaning: The PM must be posted before using the bsy command. Posting a PM 
identifies to the system the PM that is to have maintenance action. 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-830 DTC level commands 
bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


Meaning: Indicates yes has been entered in response to a prompt and that the PM 
is busied. 


Action: None 


SUMMARY : 
nnn PASSED 
nnn NO SUBMITTED 


Meaning: With the all parameter, a summary is given of the quantity (nnn) of 
XPMs in the posted set of DTCs only for the duration of the busying. 


Action: None 


THIS ACTION MAY CAUSE SWACT 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: When trying to busy an active unit, calls may be lost. Calls are not lost if 
the unit is inactive. 


Action: Use SwAct to switch the activity states to the two units so that the unit to 
be busied is inactive. 


THIS ACTION WILL TAKE AN LCM OUT-OF-SERVICE 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: This warning follows the entry of the command string bsy link (with or 
without the force command) if the link is a message link to the LCM. 


Log PM182 (for information only) is generated whenever the command 
string bsy link is initiated to make a P-side link ManB. 


Action: None 
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D-831 DTC level commands 
bsy (end) 


Responses for the bsy command (continued) 
MAP output Meaning and action 
THIS ACTION WILL TAKE THIS PM AND ALL OF ITS SUBTENDING 


NODES OUT-OF-SERVICE 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: This warning follows the entry of either of the following command 
strings: 
bsy pm 
bsy unit unit_no 
bsy unit unit_no force 


It applies to the active unit while the other unit is out-of-service. The 
active unit is made ManB while the inactive unit is made SysB or CBsy. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON nnn DTCS 
PLEASE CONFIRM  (“YES”, “Y”, “NO”, OR “N”) 


Meaning: A quantity of nnn DTCs in the posted set is to be busied. 


Action: If the user enters YES, the XPMs are busied 
If the user enters NO, the action is aborted. 


When the user responds with YES, the status display of the DTC in the 
current position of the posted set changes to ManB and the status 
display for the PM level, under the header ManB, will be incremented by 
one. 
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DTC level commands D-833 
disp 


Function 
Use the disp command to display a list of all DTC in a specified PM state. 


disp command parameters and variables 


Command Parameters and variables 


m_type 
state pm_state all 
pm_type 


diaghist posted | 


Parameters 
and variables Description 


This parameter causes a summary of the history of diagnostic failures for the se- 
lected PMs. 


This variable is one of the following PM states: 
SysB system busy 
ManB manual busy 
OffL offline 
CBsy C-side busy 
ISTb in-service trouble 
InSv in-service 


pm_type This variable indicates the type of PMs for which information is to be displayed. For 
DTCs the PM type is DTC. 


posted This default parameter, which is never entered, indicates that all PMs will be af- 
fected by the display command because no PM type is specified. 


state This parameter indicates that PMs in the specified state are to be displayed. This 
parameter must be followed by a pm_state variable. 


Qualifications 
The disp command is qualified by the following exceptions, restrictions, and 
limitations: 
e The diaghist parameter pertains only to XPMs supported by feature 
AF5006. 
e Two sets of counters are used to save information for the diaghist 


parameter function, long term failures (LTF) and short term failures 
(STF). 
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D-834 DTC level commands 
disp (continued) 


e The following diagnostics are supported by the PM Diagnostic History 
feature, AF5006, and may be reported in a diagnostic history. 


Diagnostic Description Type (solicited | Required by 
name or audit) SwAct controller 


AB DIAG 
AMUDIAG 
CDS1 DG 
CMRDIAG 
CONT DG 
CSMDIAG 
CS SPCH 
DCHIALB 
DS1DIAG 
DS30A 
FORMATR 
ISPHDLC 
ISPSPHI 
ISPSPHF 
MSGDIAG 
MSG IMC 
MX76MSG 
PADRING 
PARITY 
PS LOOP 
PS SPCH 
RCC FMT 
SCM AB 
SCM MSG 
SPCH DG 
STRDIAG 
SYNC DG 
FAC AUD 
TONE DG 
TS DIAG 
UTRDIAG 


A/B Bits 

6X50 External Loop 
CSide DS1 

CMR CardO 

Continuity Diag 

CSM Diag 

Network Links 

DCH Inactive Loopback 
PSide DS1 

6X48 / MX74 Audit 
Local Formatter 

ISP HDLC Diag 

ISP Speech Bus Internal 
ISP Speech Bus Full 
6X69 Messaging Card 
IMC Link 

MX76 Messaging Card 
6X80 Pad/Ring 

Parity Audit 

PSide Loops 

PSide Speech Links 
Remote Formatter 
6X81 A/B Bits 

SCM A/B DDL Msg 
Speech Path 

Special Tone Receiver 
Sync Diag 

Facility Audit 

Tone Diag 


Time Switch Diag 
UTR Card 
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solicited 
solicited 
solicited 
both 
solicited 
solicited 
solicited 
solicited 
solicited 
audit 
solicited 
solicited 
solicited 
solicited 
solicited 
both 
solicited 
solicited 
audit 
solicited 
solicited 
solicited 
solicited 
solicited 
solicited 
solicited 
both 
audit 
both 
solicited 
solicited 


DTC level commands D-835 
disp (continued) 


e The following cards are supported by the AF5006 feature and may be 
reported in a diagnostic history. 


NT6X40 Net Interface Link 

NT6X41 Speech Bus Formatter and Clock 
NT6X42 CSM 

NT6X44 Timeswitch and A/B Bit Logic 
NT6X45 Master/Signalling/File Processor 
NT6X46 SP Memory 

NT6X47 MP Memory 

NT6X48 DS30A Interface 

NT6X50 DS1 Interface 

NT6X55 DSO Interface 

NT6X62 STR Card 

NT6X69 Messaging Card 

NT6X70 Continuity Card 

NT6X72 RCC Host Link Formatter 
NT6X78 CLASS Modem Resource (CMR) 
NT6X79 Tone Generator 

NT6X80 SCM Pad/Padring 

NT6X81 SCM A/B Bit 

NT6X85 SCM DS1 

NT6X86 SCM MSG 

NT6X92 Universal Tone Receiver (UTR) 
NT8X18 SMSR CSide DS30A Interface 
NTBX01 ISDN Signalling Processor (ISP) 
NTBX02 DCH 

NTMX76 CSM + MSG Card 

NTMX77 68020 Processor (UP) 
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D-836 DTC level commands 
disp (continued) 


Examples 
The following table provides examples of the disp command. 


Examples of the disp command 


Example Task, response, and explanation 
disp state bsy DTC — 
Task: Display all busy DTCs 


Response: Bsy DTC 0, 1 


Explanation: There is one busy DTC, LGG 0 unit 1. 
disp diaghist — 
Task: Display the diagnostic history for all XPMs. 


Response: 

DTC 0 Long-Term Failure (LTF) last reset: 92/07/01 03:12:14 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/03 03:10: 
Last diagnostic failure: 92/07/04 13:35:50 

DIAGLIST STF LTF 
AB DIAG 3 3 
CARDLIST STF LTF 
NT6X44 2 2 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/01 03:12: 
Last diagnostic failure: 92/06/02 14:00:31 
No failures recorded 


DTC 0 Long-Term Failure (LTF) last reset: 92/07/01 07:19:41 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/02 02:31: 
No failures recorded 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/03 02:01: 
No failures recorded 


Explanation: No failures have been recorded on unit 1 of DTC 0 since the last 
LTF reset time. The last diagnostic failure was before the LTF reset 
time. DTC 0 displays no last diagnostic failure line because it has 
no failures in its lifetime. 
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DTC level commands D-837 
disp (continued) 


Examples of the disp command (continued) 


Example Task, response, and explanation 
disp diaghist rcc J 


Task: Display the diagnostic history for all RCCs 


Response: 
RCC 0 Long-Term Failure (LTF) last reset: 92/07/01 03:12:14 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/03 03:10:23 
Last diagnostic failure: 92/07/04 13:35:50 
No failures recorded 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/01 03:12:14 
Last diagnostic failure: 92/06/02 14:00:31 
DIAGLIST STF LTF 
AB DIAG 1 3 
CARDLIST STF LTF 
No cards reported by the XPM 


Explanation: Only the history for the RCC is displayed. 
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D-838 DTC level commands 
disp (continued) 


Responses 


The following table describes the meaning and significance of responses to 
the disp command. 


Responses for the disp command 
MAP output Meaning and action 
<pm_state> DTC: NONE 


or 
<pm_state> DTC n, n 


Meaning: There are no PMs in the specified state, or all in the state are listed, 
where <pm_state> is the state specified in the command. 


Action: None 
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DTC level commands D-839 
disp (end) 


Responses for the disp command (continued) 


MAP output Meaning and action 


<PMID> Long-Term Failure (LTF) last reset : <yr-month-day> <hr:min:sec> 
UNIT 0 Short-Term Failure (STF) last reset: <yr-month-day> <hr:min:sec> 
Last diagnostic failure: <yr-month-day> <hr:min:sec> 
DIAGLIST STF LTF 
<diag_name> <counts> <counts> 


<diag_name> 


CARDLIST 
<card_name> 


<card_name> <counts> <counts> 


UNIT 1 Short-Term Failure (STF) last reset: <yr-month-day> <hr:min:sec> 
Last diagnostic failure: <yr-month-day> <hr:min:sec> 
DIAGLIST STF LTF 
<diag_name> <counts> <counts> 


<diag_name> 


CARDLIST 
<card_name> 


<card_nam 


Meaning: This is the response to a disp diaghist command, where 


<PMID> is the type of PM such as DTC, DTC, or RCC 
<yr-month-day> year, month, and day 

<hr:min:sec> hour, minute, and second 

<diag_name> the name of the diagnostic test 


<counts> the number of short term or long term failures 
Action: None 
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DTC level commands D-841 
listset 


Function 


Use the listset command to list the discrimination numbers of the PM types 
included in the posted set. 


listset command parameters and variables 


Command Parameters and variables 


listset posted 


pm_type 
all 


Parameters 
and variables Description 


pm_type This variable specifies the type of PM in the posted set that is to be listed with all 
of its discrimination numbers. 


posted This default parameter, which is never entered, indicates that all PMs of the same 
type as the PM currently posted will be listed because neither a pm_type nor the 
all parameter is specified. 


This parameter lists all of the PM types that are in the posted set including their dis 
crimination numbers. 


Qualifications 


The listset command is qualified by the following exceptions, restrictions, 
and limitations: 


e use the listset command to plan maintenance actions on sets of XPMs of 
the same type. 


e entering the command string help listset to display the syntax of the 
command at the MAP shows all of the PM types that use the listset 
command; however, only PMs included in the office configuration can 
be selected. 
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D-842 DTC level commands 
listset (continued) 


Example 
The following table provides an example of the listset command. 


Example of the listset command 


Example Task, response, and explanation 
listset all ı 


Task: List all of the PM types that are in the posted set. 


Response: pm_type pm_number, pm_number ... 


pm_type pm_number, pm_number ... 


Explanation:The discrimination numbers of all the specified PM types in the 
posted set are listed. 


Responses 


The following table describes the meaning and significance of responses to 
the listset command. 


Responses for the listset command 
MAP output Meaning and action 


pm_type pm_number, pm_number ... 


pm_type pm_number, pm_number ... 


Meaning: The discrimination numbers of all the specified PM types in the posted 
set are listed. 


Action: None 


NO PMS FOUND 


Meaning: The posted set of XPMs is empty. 


Action: None 
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DTC level commands D-843 
listset (end) 


Responses for the listset command (continued) 


MAP output Meaning and action 


NO PMS OF SPECIFIED PM TYPE FOUND 


Meaning: The posted set does not contain XPMs of the specified type. 


Action: None 
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DTC level commands D-845 
loadnotest (end) 


Function 


The loadnotest command is obsolete. Use the loadpm command with the 
force parameter. See the loadpm command for details. 
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DTC level commands D-847 
loadpm 


Function 
Use the loadpm command to load the peripheral program files into the 
processors of one or all posted DTCs. The PMs must be ManB or SysB 
before entering the loadpm command. 


loadpm command parameters and variables 


Command Parameters and variables 


inactive actfile noforce posted 
pm I name || force all Br | 


unit unit_no backup r_name 


Parameters 
and variables Description 


The default parameter, which is never entered, indicated that the load file will be the 
one specified in field ACTFILE of table PMLOADS, because neither a file name o 
backup were specified. 


This parameter simultaneously loads all of the specified unit(s) or XPMs of the 
same node type as the XPM in the current position of the posted set. 


This parameter specifies that the backup file specified in field BKPFILE of table 
PMLOADS is the loadfile to be used. 


This parameter specifies that the source of the load data is to be the DMS-100 cen- 
tral control (CC) data store. 


This parameter specifies that the CMR card will be loaded for the specified unit or 
units of the posted DTC. 


This parameter selects the load which consists of the static data and execs, but ndt 
the basic DTC software. Static data and tables define the configuration of the DT( 
and subtending PMs. 


When loading static data into the PM the NT6X78 CLASS Modem Resource (CMR) 
card in the DTC is also loaded if table DTCINV is datafilled. 


This default parameter, which is never entered, indicates that the file used with the 
all parameter for loading will be the default file specified by the /_ name variable be 
cause no r_name variable is specified. 
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D-848 DTC level commands 
loadpm (continued) 


loadpm command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter selects the load mode to be execs only. Execs are sets of instruc 
tions executed by the DTC in response to aCC request or DMS action. Execs be 


have like mini-programs to handle call processing. 


This variable is the name of the CC data file for the posted DTCs. Load names arẹ 
listed in data table DTCINV, field LOAD. The load's file name also appears on thg 
display of the command querypm nextto FNAME. The device on which the load 
resides is specified in data table PMLOADS. 


By not specifying a load's file name, with parameter all, the XPMs are loaded with 
the file name recorded in the respective XPM inventory tables. More than one loag 
can be used to load more than one PM. 


This parameter bypasses the running of the ROM tests while loading occurs. 


This parameter selects the load mode which consists of the basic DTC software, 
plus the execs and the static data in the CC. The parameter full is the default if nq 
load mode is entered. 


This parameter loads the unit(s) that are in the inactive state. If the parameter all 


is specified, XPMs with firmware card NT6X45BA or later are loaded by the mate 
unit. 


If the status display for the unit (s) activity is blank, the CC prevents the loading. 
The action must be done by using explicit parameters. 


During an upgrade of XPM software, and with parameter all, the inactive units that 


are to be loaded from their mate units display broadcast mate as their maintenancp 
flag. 


This default parameter, which is never entered, indicates that the ROM tests will bp 
run because the force parameter was not entered. 


This parameter allows another DTC to be posted and loaded without waiting for 
confirmation from the previous load request. The parameter nowait also enables 
the MAP to be used for other entries while loading proceeds. Error messages for 
the loadpm command are generated in PM logs. 


This parameter loads both units of one or all posted DTCs. 


This default parameter, which is never entered, indicates that only the posted DTC 
in the control position will be loaded because the all parameter is not entered. 


This parameter loads one unit of one or all posted DTCs. 
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DTC level commands D-849 
loadpm (continued) 


loadpm command parameters and variables (continued) 


Parameters 
and variables Description 


This variable is the name of the load that is to replace the load’s file name (I_name 
for those PMs that cannot be loaded by the I_ name load. Replacement names fo 
such PMs must be listed in data table DTCINV. The device on which the load re- 
sides is specified in table PMLOADS. 


unit_no This variable specified which unit of the posted DTC is to be loaded. The range is 
Oor 1. 


This default parameter, which is never entered, indicates that load request con- 
firmation and error messages will not be suppressed, and the MAP cannot be used! 
for additional commands until the loadpm command has completed executing be- 
cause the nowait parameter was not entered. 


Qualifications 


The loadpm command is qualified by the following exceptions, restrictions, 
and limitations: 


e While loading occurs, a series of maintenance flags display its progress. 


e With the parameter all, the more XPMs there are, the longer it takes to 
complete the loading. Other maintenance activities will be delayed. 


e When using the parameter pm, the load file name is taken from the data 
table, and displayed by the command querypm. 


e When the DTC is not loaded, the only programs that are present for 
testing are located in the ROM. If the ROM test fails, the loadpm 
command cannot be used. If the ROM tests have already passed, the 
unlisted menu command loadnotest bypasses the ROM tests. The time 
taken for a ROM test that is already successful is not repeated. 


e To reload a PM, enter the loadpm command on the inactive unit, then 
enter the swact command when it is completed, and then re-enter loadpm 
for the newly inactive unit. 

e When loading for the PM occurs, the NT6X78 CMR card in the DTC is 
also loaded if the data table DTCINV is datafilled. 

e To locate a load’s file name, use the commands dskut and listvol. Load 
file names are listed in data table PMLOADS. 


e The failure reasons that prevent PMs in a posted set from being loaded 
by broadcast loading are described alphabetically as follows: 
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D-850 DTC level commands 
loadpm (continued) 


- LOAD NOT RECEIVED FROM BROADCAST LOADER 


The PM through which the load was to be sent has not sent the load. 
It may be out of service. 


- NO RESPONSE FROM IPML SETUP MESSAGE 


The XPM has not responded to the IPML setup that is required for 
broadcast loading to occur. 


- NO RESPONSE FROM NIL EVENT TIMEOUT MESSAGE 


The XPM has not responded to the nil event timeout message. 
- NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


The XPM has not responded to the ROM and RAM query message. 


Examples 
The following table provides examples of the loadpm command. 


Examples of the loadpm command 


Example Task, response, and explanation 


loadpm unit 1 J 
where 


1 is the unit number of the posted DTC to be loaded 


Task: Load the peripheral program files into the processor of DTC unit 1. 


Response: DTC 0 ISTb Links_00S: CSide 0 PSide 0 
Unit 0: Act InSv 
Unit 1: InAct ManB Mtce /Loading: 0200 
LOADPM UNIT 1 


Explanation:The message indicates the loading is taking place. 
loadpm pm cc full backup - 


Task: Load the posted pm with the backup loadfile specified in table 
PMLOADS. 


Response: Not currently available. 


Explanation:Not currently available. 


297-1001-821 Standard 04.01 June 1999 


DTC level commands D-851 
loadpm (continued) 


Responses 


The following table describes the meaning and significance of responses to 
the loadpm command. 


Responses for the loadpm command 
MAP output Meaning and action 


6X45 PEC MISMATCH 
available_pecs 


Meaning: Loading cannot occur because the data entry in the inventory table does 
not match the PEC of the NT6X45 card. 


Action: The equipped PECs of NT6X45 cards are listed, where pecs. Ifa 
question mark (?) is present instead of a PEC, the PEC can only be 
obtained by inspecting the appropriate card. 


Action: Check the PECs of the NT6X45 cards in use and ensure that the one 
with the lowest suffix is the one datafilled in inventory table DTCINV. 


FAILED TO SEND RESET MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not reset. The card is one or more of the listed cards, 
where card_list is one of: 

NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 
NT6X72 


Action: None 
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D-852 DTC level commands 
loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card _list is one of: 

NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X69 


Action: None 
INACTIVE PARAMETER NOT VALID FOR OOS PM 


Meaning: The parameter inactive does not apply to out-of-service XPMs. The 
XPM(s) must be in service. 


Action: The activity display for the XPM(s) is blank 
Action: To load the XPM(s) that are bypassed from the posted set, busy the 
XPMs with the command bsy and use the command loadpm with the 


parameter unit or pm. 


LOAD FILE file_name NOT FOUND IN SYMBOL TABLE 


Meaning: The variables /_name or r_name is not found in the system's symbol 
table. The symbol table is a pseudo-table for storing data for the 
duration of a MAP session. It is not a data table and is emptied by a 
reload or a restart. 


Check for a typo or check data table DTCINV for the applicable r_name. 
Unless the location of the load file is listed in data table PMLOADS, list 
the volume with the load's file name. 
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loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 


LOAD FILE NOT IN DIRECTORY 


Meaning: The system cannot find the location of the load file. lt resides on tape or 
disk. Use the command list to list the disk volume or the command 
mount to mount the tape that has the load file on it. The list and mount 
commands are described in the Nonmenu Commands Reference 
Manual, 297-1001-820. 


Action: None 


DTC pm_number UNIT u BROADCAST LOAD REQUEST SUBMITTED 


Meaning: The PMs in the posted set are being loaded by the broadcast method 
from the mate units, where pm_number and unit u are the discrimination 
numbers of the specific PM(s). 


Action: None 


pm_type pm_number IS status 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for loading, where pm_type is a PM 
listed in table A on page 18, pm_numberis the discrimination number of 
the PM, and status is one of the following: 


CBSY 
INSV 
OFF-LINE 


The PM must be ManB. 


Action: None 


DTC pm_number LOADED 


Meaning: The PM has been successfully loaded. 


Action: None 


DTC pm_number UNIT u LOAD FILE file_name IS NOT AVAILABLE 


Meaning: The parameter has already been used and the PM load file_name has 
already been identified as being unavailable. 


Action: The PM in the posted set is bypassed from the loading 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


DTC pm_number LOAD FILE IN INVENTORY TABLE NOT FOUND 
ENSURE THAT TABLE PMLOADS IS DATAFILLED CORRECTLY 


Meaning: The load's file name (parameter /_name) is not specified and the file 
name in the inventory data table does not correspond to a valid device 
in table PMLOADS. 


Action: The PM in the posted set is bypassed from the loading. 


DTC pm_number UNIT u LOADPM FAILED 
reason 
CAUSED FAILURE OF BROADCAST LOADER 


Meaning: As a member of the posted set intended for participation with broadcast 
loading, a PM’s failure to be loaded prevents the broadcast loading from 
occurring. Reasons for the failure are listed in qualifications. 


Action: None of the PMs to be loaded by the broadcast method are loaded. 
PMs in the posted set using the single loading method are loaded 


Action: To allow the broadcast loading to proceed, remove the PM with the 
failure from the posted set and try again. 


DTC pm_number LOADPM FAILED 
LOAD NOT RECEIVED VIA BROADCAST LOADER 


Meaning: As a member of the posted set intended for participation with broadcast 
loading, this DTC is not loaded because of a failure in another PM. 


Action: None of the PMs to be loaded by the broadcast method is loaded. PMs 
in the posted set using the single loading method are loaded 


Action: Investigate the cause of the failure to load the PM that is identified by the 
response CAUSED FAILURE OF BROADCAST LOADER. To proceed 
with the broadcast loading, remove the failed PM from the posted set 
and try the loadom command again. 


DTC pm_number UNIT u LOAD REQUEST SUBMITTED 


Meaning: Only the PM in the current position of the posted set is being loaded 
from the CC. 


Action: None 
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loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 
DTC pm_number MTCE IN PROGRESS ON EITHER OR BOTH UNITS 
Meaning: The DTC cannot be loaded because it is already undergoing 
maintenance action, where pm_number is the discrimination number of 


the DTC. 


Action: With parameter all, the DTC is bypassed from the posted set of DTCs 
only for the duration of the loading. 


DTC pm_number NOT SUBMITTED AS INACTIVE UNIT NO LONGER MANB 
OR ACTIVE UNIT IS NOW OOS 


Meaning: As a member of the posted set intended for participation with broadcast 
loading, the PM is no longer manually busy (ManB state) or the active 
unit is no longer in service. 


Action: The PM in the posted set is bypassed from the loading. 


DTC pm_number NOT SUBMITTED AS STATE NO LONGER MANB 


Meaning: The PM’s units are not both manually busy (ManB state). 
Action: The PM in the posted set is bypassed from the loading. 


DTC pm_number UNIT u REPLACEMENT NAME MISMATCH 
WITH INVENTORY TABLE 


Meaning: The specified load replacement file name does not match the file name 
datafilled in the inventory table of this PM. 


Action: The PM in the posted set is bypassed from the loading. 


reason 
NO ACTION TAKEN 


Meaning: The command cannot be executed for a reason other than those given 
in the standard responses. 


Action: None 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


NO RESPONSE FROM PM AFTER ROMTEST 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card _listis one of 

NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 


Action: None 


NO RESPONSE FROM PM AFTER STATUS 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card_listis one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 

NT6X69 


Action: None 


NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


Meaning: The loading cannot occur because the datafilled entry in the inventory 
does not match the PEC of the NT6X45 card or there is no response to 
the ROM/RAM query. If the parameter nowait is specified, this response 
does not appear. 


Action: The maintenance flag ROM/RAM QUERY appears for the duration of the 
query. 


Action: Check the PECs of the NT6X45 cards in use and ensure that the one 
with the lowest suffix is the one datafilled in table DTCINV. 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


NO WAIT RECEIVED AFTER RESET 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not present. The card is one or more of the listed 
cards, where card _listis one of 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 

NT6X46 (FP memory) 
NT6X47 

NT6X50 

NT6X69 

NT6X72 


Action: None 


PM FAILED TO INITIALIZE 
TRY RELOADING THE PM 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not initialized. 


Action: Reload the XPM by entering the command pmreset or loadpm at a MAP. 


DTC pm_number REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With parameter all, an XPM in the posted set cannot be loaded because 
it is not in the manually busy state. 


Action: The PM in the posted set is bypassed from the loading. 


Action: To proceed with the maintenance, wait until the action on the posted set 
is completed, then busy the XPM with the command bsy before trying 
the command loadpm. 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


REPLACE CARDS IN CARDLIST 
card_list 


Meaning: The results of the tests by the mate unit indicate that the cards are 
preventing the loading, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 
RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Re-enter the command loadpm. 


SUMMARY: 
nnn PASSED 
nnn NOT SUBMITTED 


Meaning: With parameter all, a summary is given of the quantity (nnn) of XPMs in 
the posted set that have been successfully loaded or that have been 
bypassed by the loading. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON nnn DTC 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: A quantity of nnn DTCs in the posted set is to be loaded. 


Action: Entering Yes loads the DTC(s) 
Entering No aborts the action. 


Action: With YES, the status display of the DTC in the current position of the 
posted set shows the maintenance flag Mtce and shows the progression 
of the loading. 

TOO MANY CHARACTERS IN REPLACEMENT NAME 


Meaning: The variable r_name must be a string of eight characters or less. 


Action: Check for a type or check data table DTCINV for the applicable 
r_name. 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


TOO MANY DIFFERENT LOAD FILES REQUIRED. 
TRY A SMALLER SET OF PMS 


Meaning: This response is to the command string loadpm pm all when the quantity 
of load file names in the respective inventory data tables is too large. 


Action: Use the command post to create a posted set either with fewer PMs or 
with PMs that use the same load file name, and re-enter the command. 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: Mate loading is cancelled if the status or the activity of the active unit 
changes. 


Action: Wait for the changes to complete. 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: Mate loading cannot occur when key software modules are missing from 
the load. 


Action: Wait for the resources to become available. 


UNABLE TO DIAGNOSE FROM MATE 
MATE MTCE IN PROGRESS - TRY AGAIN LATER 


Meaning: As part of the maintenance actions for testing a unit by its active mate, 
loading from the mate unit cannot occur when maintenance is already in 
progress on it. 

Action: Wait for the maintenance action(s) to complete. 


WAITING FOR RESOURCES TO BECOME AVAILABLE 


Meaning: The system must wait to do maintenance action because the maximum 
quantity of loading requests has been submitted. 


Action: Wait for the loading to complete or cancel the request with command 
abtk. 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


WARNING: LOAD FILE file name HAS SAME NAME AS 
DATAFILLED IN INVENTORY TABLE BUT 
IS NOT ON THE SAME DEVICE AS 
INDICATED BY TABLE PMLOADS 


Meaning: Two load file names are the same in a PM inventory data table and in 
table PMLOADS. The specified file name matches the name in the 
inventory table, but not the name in table PMLOADS. 

Action: The PM in the posted set is bypassed from the loading. 

Action: Check table PMLOADS for the correct file name. 


Load file on command line not supported 
when loading the CMR 


Meaning: When loading the CMR, it is not valid to specify a load file on the 
command line. The load file specified in the inventory table will be used. 


Action: Reissue the loadpm command without specifying the CMR load name. 


CMR file <CMR_file_name> not found on the device 
indicated in table PMLOADS or in symbol table 


Meaning: A loadpm command was issued and the load file name indicated by 


<CMR_file_ name> 


in the response and datafilled in the inventory table is not found on 
the device indicated in PMLOADS or in the user’s symbol table. 


Ensure that the CMR load datafilled in the inventory table exists on the 
device indicated by Table PMLOADS, or list the device where the 
loadfile resides, such as dskut;listvol d010pmload all. 


DTC X Unit Y request submitted. 


Meaning: The nowait parameter is entered. This message is produced to indicate 
the load request has been submitted, where 
x is the DTC number 
Y is the unit number of the DTC. 


Action: None 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


DTC X Unit Y LoadPM Aborted 
Reason: ABTK from user <username> 


Meaning: The loading process has been aborted by another user, where 
x is the DTC number 
Y is the unit number of the DTC 
<username> is the name of the user submitting the abtk command. 


Action: Investigate the reason the other user aborted the loading. 


DTC X WARNING: CMR file >CMR_file_name> has same name 
as datafilled in inventory table but 
is not on the same device as 
indicated by table PMLOADS 


Meaning: The CMR file to be loaded has the same name as that datafilled in the 
inventory table. This file is not the same as the one defined in table 
PMLOADS. Two load files of the same name exist. The CMR will not 
be loaded. 


None 
DTC X Unit Y CMR not datafilled in inventory table. 


Meaning: The optional card CMR and its load name are not datafilled in the 
inventory table, where 
x is the DTC number 
Y is the unit number of the DTC. 


Add CMRxx, where xx specifies the slot number, to the OPTCARD list 
and the CMR load name to the CMRLOAD filed in the inventory table for 
the specified DTC. Ensure that the CMR card is in the correct slot as 
specified by xx. 


DTC X Unit Y CMR card must be ManB 
Meaning: The CMR card must be manually busy to be loaded where 
x is the DTC number 
Y is the unit number of the DTC. 


Action: Busy the CMR card with the bsy command. 
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loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 
DTC X Unit y Unit not InSv 


Meaning: The DTC must be in service, either InSv or IsTb for the CMR to be 
loaded, where 


x is the DTC number 
Y is the unit number ofthe DTC. 


Action: Ensure the DTC is in service. 


DTC X Unit Y LoadPM failed. 
<reason> 


Meaning: The PM has a failure which is indicated where 
x is the DTC number 
Y is the unit number of the DTC 
<reason> is the reason for the failure. 
Action: Investigate and correct the failure. 
Force parameter not valid when loading CMR 
Meaning: The force parameter was entered with the load cmr command. 
Action: Enter the command without the force parameter. 
ALL parameter not valid when loading the CMR 
Meaning: The all parameter was entered with the load cmr command. 


Action: Enter the command without the all parameter. 


Loading a CMR on an Active Unit will 
degrade DTC call processing real time. 
Do you still want to LOAD the CMR? 


Meaning: A CMR in an active unit of an XPM is to be loaded. This message 
explains that the XPM call processing real time will be impacted. 


Action: To continue the loading process enter “yes.” To terminate the loading 
process enter “no.” 
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loadpm (end) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


DTC X Unit Y No action taken - Mtce in Progress 


Meaning: The DTC was loading the CMR when an attempt was made to bsy the 


DTC unit. The loading ofthe CMR continues. This is an output 
message, where 


x is the DTC number 
Y is the unit number ofthe DTC. 


Action: None 


DTC X Request Invalid 


Mtce in progress on either or both units 


Meaning: The DTC was loading the CMR when an attempt was made to SwAct 
the XPM. Loading continues. 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


DTC level commands D-865 
next (end) 


Function 


Use the next command to place the next higher PM of the set of posted 
DTCs into the control position. 


next command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that the next PM in the 
post set, regardless of type, will be posted because no pmtype is specified. 


This variable specifies a pm type and enables the system to select a specific PM 
type to post. Use the disp command to display the list of PM types in the posted 
set. The system selects the PMs in the sequence displayed by this list. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


The following table describes the meaning and significance of responses to 
the next command. 


Responses for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed PM is the last in the posted set of PMs. 


Action: None 
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offl 


Function 
Use the offl command to place the specified DTC or DTCs in the offline 
state. 


offl command parameters and variables 


Command Parameters and variables 


posted 
all 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that only the currently 
posted DTC will be affected by the offl command because the all parameter was npt 
entered. 


This parameter makes offline all XPMs, or their specified units, which are the same 
node type as the XPM currently posted. 


Qualifications 


This command is qualified by the following limitation: 
An off-line DTC remains in this state through all restarts. 


Examples 
Not currently available 


Responses 
The following table describes the meaning and significance of responses to 


the offl command. 


Responses for the offl command 


MAP output Meaning and action 


Meaning: The posted DTC is made offline. 


Action: None 
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offl (continued) 


Responses for the offl command (continued) 
MAP output Meaning and action 


pm_type pm_number IS status. 
NO ACTION TAKEN 


Meaning: The PM is already offline or is in the incorrect state for being made 
offline, where pm_type is a PM listed in Table A on page 18, pm_number 
is the discrimination number of the PM, and status is one of 


CBSY 
OFFL 
SYSB 


The PM must be ManB. 


Note: For some PM types, REQUEST INVALID appears before NO 
ACTION TAKEN. 


Action: None 


DTC pm_number MTCE IN PROGRESS ON EITHER OR BOTH UNITS 
Meaning: The DTC cannot be made off-line because it is already undergoing 


maintenance action, where pm_number is the discrimination number of 
the DTC. 


Action: With parameter all, the DTC is bypassed from the posted set of DTCs 
only for the duration of being made offline. 


DTC pm_number REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With parameter all, an DTC in the posted set cannot be made off-line 
because it is not in the manually busy state. 


Action: The DTC is the posted set is bypassed from being made offline. 


Action: To proceed with the maintenance, wait until the action on the posted set 
is completed, then make the DTC busy with the command bsy before 
trying the command offline. 
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offl (end) 


Responses for the offl command (continued) 
MAP output Meaning and action 
SUMMARY 


nnn PASSED 
nnn NOT SUBMITTED 


Meaning: With parameter all, a summary is given of the quantity (nnn) of XPMs in 
the posted set that have been successfully made offline or that have 
been bypassed by the request. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON nnn DTCS 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: A quantity of nnn DTCs in the posted set is to be made off-line. 


Action: Entering YES makes the DTCs off-line. Entering NO aborts the action. 


Action: With YES, the status display of the DTC in the current position of the 


posted set changes to offl and the status display under the header OFFL 
is increased by one. 
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perform 


Function 


Use the perform command to access the perform level where details of the 
activity and performance of a posted PM can be monitored. This feature 
requires feature package NTX827 or NTX750. 


perform command parameters and variables 
Command Parameters and variables 
perform 


Parameters 
and variables Description 


This default parameter, which is never entered, cancels the setup for the office be 
cause lab parameter is entered. 


This parameter specifies a setup for the office as the menu and display of the posted 
PM is accessed. The setups automatically vary according to the type of PM that 
is posted. This parameter is for lab use only. 


Qualifications 


The perform command is qualified by the following exceptions, restrictions, 
and limitations: 


e The posted PM must be in service (status InSv) or have in-service 
trouble (status ISTb). 


e Only the active unit is monitored. 
e Only one user at at time can monitor the performance of the posted PM. 


e The measurements are recorded for the status displays within one hour 
of starting the measurements. The maximum measuring duration is one 
hour from its starting. 


e Measurements are not maintained during or after a warm or cold SwAct. 


e Measurements are maintained during a busying or returning to service of 
an active unit. 


e The performance process can monitor up to five PMs. 
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D-872 DTC level commands 
perform (continued) 


Example 
The following table provides an example of the perform command. 


Example of the perform command 


Example Task, response, and explanation 
perform J 
Task: Access the perform level for the currently posted DTC. 


Response: LOAD NAME: NLG35CN 
STATUS: REASON: LOGS: 


Explanation: The PERFORM level is accessed. 
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perform (continued) 


Responses 


The following table describes the meaning and significance of responses to 
the perform command. 


Responses for the perform command 
MAP output Meaning and action 
display 
Meaning: The perform display and menu appears. 


Action: None 


DISPLAY PROCESS DIED 


Meaning: The Perform tool cannot be accessed until the display process is 
restored. 


Action: None 
FAILED TO INITIALIZE DIRECTORY 
Meaning: A system problem is interfering with the access of the Perform tool. 


Action: Try again later when more resources are likely to be available. 


MAXIMUM NUMBER OF PMS IN USE 
PLEASE WAIT UNTIL SOMEONE QUITS 


Meaning: A maximum of ten peripherals can be analyzed by the Perform tool at 
the same time. 


Action: Wait until the analysis is complete on one of the ten peripherals. 


MAXIMUM NUMBER OF DISPLAYS IN USE 
PLEASE WAIT UNTIL SOMEONE QUITS 


Meaning: A maximum of five MAPs can access the Perform level or its sublevels 
at the same time. 


Action: Wait until a MAP is made available. 
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perform (continued) 


Responses for the perform command (continued) 
MAP output Meaning and action 
PERFORM ALREADY BEING USED ON THIS PM BY map_id 


Meaning: Another MAP has already specified the PM for posting for the perform 
analysis. 


Action: Wait until the peripheral is no longer posted for perform command. 
PERFORM NOT VALID ON THIS PM 
Meaning: The perform tool does not analyze the type of specified PM. 


Action: None 


PERIPHERAL IN USE 
Meaning: The PM is already undergoing the performance process. 


Action: None 


PERIPHERAL IS NOT INSV OR ISTB 


Meaning: The active unit of the PM must be in the in-service (InSv) or in-service 
(ISTb) state. 


Action: None 
PM LOAD DOES NOT SUPPORT THE PERFORM TOOL 


Meaning: The feature package that provides the Perform analysis does not include 
this type of PM. 


Action: A software reload may be required as an upgrade to allow perform to 
analyze the specified type of PM. 


POST COMMAND NOT VALID IN THIS TOOL 
TO POST THE PERIPHERAL, FIRST QUIT FROM PERFORM 


Meaning: While the Perform tool is accessed, PMs cannot be added to the posted 
set. The PMs to be analyzed by perform must be posted before the tool 
is accessed. 


None 
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Responses for the perform command (continued) 


MAP output Meaning and action 


THERE ARE FIVE USERS USING THIS TOOL 
PLEASE WAIT UNTIL A PROCESS IS STOPPED 


Meaning: The performance process can monitor only up to five PMs 
simultaneously. 


Action: None 
XPM DOES NOT SUPPORT PERFORM TOOL 
Meaning: If the XPM does not respond to the command perform within a 


10-second timeout, it is assumed that the XPM does not use the Perform 
tool. 


Action: You cannot enter other commands at the MAP during the timeout. 
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pm reset 


Function 


Use the pmreset command to reinitialize a posted DTC or one of its units 
after being reloaded using the loadpm command. This reset verifies that the 
reload is correct. 


pmreset command parameters and variables 
Command Parameters and variables 
pmreset tstdat 


unit_no nodata 
norun 


Parameters 
and variables Description 


pm This parameter reinitializes both units of the posted DTC. 

norun This parameter resets the PM without initializing or sending static data and execs. 

unit This parameter reinitializes one unit of the posted PM. 

unit_no This parameter specifies which unit of the posted PM is to be reset. The range is 
0-1. 

nodata This parameter resets the units after initialization without sending data and execs. 

tstdat This default parameter, which is never entered, resets the units after initialization 
and sending data and execs, because neither the nodata or norun parameters are 
entered. 

Qualifications 
None 
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pmreset (continued) 


Example 
The following table provides an example of the pmreset command. 


Example of the pmreset command 


Example Task, response, and explanation 


pmreset unit 0 J 
where 


0 is the number of the unit to be reset. 
Task: Reset unit 0 ofthe posted DTC. 
Response: UNIT 0 IN ESA MODE 


THIS ACTION WILL CAUSE ESA EXIT AND ABORT 3 CALLS 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Explanation:The resetting of an DTC equipped with ESA cancels calls. 
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Responses 


The following table provides explanations of the responses to the pmreset 
command. 


Responses for the pmreset command 


MAP output Meaning and action 


DTC <pm_number> UNIT <n> DETERMINATION OF ESA STATUS FAILED 
NO REPLY FROM PM 
REQUEST PROCEEDING 


Meaning: The central control (CC) is unaware that the specified DTC is in the ESA 
mode, where <pm_number> is the discrimination number of the DTC 
and <n> is the DTC unit number (0 or 1). The system attempts to reset 
the DTC unit(s) anyway. 

Action: None 


REPLACE CARDS IN CARDLIST 
<card_list> 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the resetting, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: None 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: The mate test reset is cancelled if the status or the activity of the active 
unit changes. 


Action: Wait for the changes to complete. 
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pmreset (end) 


Responses for the pmreset command (continued) 


MAP output Meaning and action 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: Resetting for the mate tests cannot occur when key software modules 
are missing from the load. 


Action: Wait for the resources to become available. 


UNABLE TO DIAGNOSE FROM MATE 
MATE MTCE IN PROGRESS - TRY AGAIN LATER 


Meaning: As part of the maintenance actions for testing a unit by its active mate, 


resetting from the mate unit cannot occur when maintenance is already 
in progress on it. 


Action: Wait for the maintenance actions(s) to complete. 


UNIT <n> IN ESA MODE 
THIS ACTION WILL CAUSE ESA EXIT AND ABORT <nnn> CALLS 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: The resetting of an DTC equipped with ESA cancels calls, where <nnn> 
is the current quantity of calls in progress. 


Action: None 
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post 
Function 


Use the post command to select a specific DTC upon which action is to be 
performed by other commands. 


post command parameters and variables 


Command Parameters and variables 


pm_type nnn ...ann 


Parameters 
and variables Description 


This variable identifies a PM of note-type DTC. If a level of the node-type is already 
accessed, the pm_type may be omitted from the command entry. A PM in the cor} 
trol position of the posted set is the default. 


This variable identifies the discrimination number of the DTC to be posted. The 


range is 0-127. When more than one PM is to be posted, the discrimination num- 
bers are entered with a blank space separating them. 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 
limitations. 


e The post command must be used before using the commands trnsl, tst, 
bsy, rts, offl, loadpm, swact, querypm, or abtk. 


e When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs that are present in the office configuration. For parameters that do 
not apply, one of several responses indicates that it is ignored. 
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post (continued) 


Examples 
The following table provides an example of the post command. 


Examples of the post command 


Example Task, response, and explanation 


post DTC 8. 
where 


8 is the descrimination number of the DTC to be posted. 
Task: Post DTC 8. 
Response: DTC 8 InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 


Unitl: Inact InSv 


Explanation: DTC 8 is posted. 


Responses 


The following table describes the meaning and significance of responses to 
the post command. 


Responses for the post command 


MAP output Meaning and action 


NO PM POSTED 


Meaning: A PM level is accessed without any PM being posted. 


Action: None 


297-1001-821 Standard 04.01 June 1999 


DTC level commands D-883 
post (end) 


Responses for the post command (continued) 
MAP output Meaning and action 
pm pm_number n_state LINKS OOS: CSIDE nn PSIDE nn 


UNIT 0: activity u_state MTCE /LOADING: nnnn 
UNIT 1: activity u_state MCTE LOADING: nnnn 


Meaning: When a PM is posted, its status is displayed, where: 


pm is one of the types of PM listed in Table A on page 
18. 

pm_number is the discrimination number of the PM type. 

n_state is the state of the PM node. The displayed state 
depends on the state of one or both units. 

LINKS_OOS indicates the quantity of equipped C-side and P-side 
links that are out-of-service because they are either 
system busy or manually busy. 

activity indicates which unit is available for call processing 
and which unit is on standby. ACT means the unit is 
active and able to handle call processing, INACT 
means the unit is on standby (inactive). 

u_state is the status of a unit. 

MTCE indicates the unit is undergoing maintenance initiated 
manually or by the system (displayed with u_states 
ManB and SysB, respectively). MTCE is present 
only while maintenance is occurring. 

/LOADING: indicates the unit is being updated with datafill, where 
nnnn is an increment of the load. 


Action: None 


<PM> <num> InSv Links_OOS: CSide 0, PSide 0 
UnitO: Act InSv 
Unitl: Inact InSv 


Meaning: The specified <PM> nunmber <num> is posted. 


Action: None 
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querypm 


Function 


Use the querypm command to display miscellaneous information about a 
posted DTC. 


querypm command parameters and variables 


Command Parameters and variables 


querypm cnirs 
diaghist 


Parameters 
and variables Description 


This parameter causes only card counts to be displayed for the diagnostic history. 


This parameter displays the contents of the DTC maintenance counters which re- 
cord the number of times that each fault (flt) condition has occurred. It also displays 
the ROM and RAM load names. 


This default parameter, which is never entered, indicates that both diagnostic 
counts and card counts will be displayed for the diagnostic history. 


This parameter causes only diagnostic counts to be displayed for the diagnostic hif- 
tory. 


This parameter causes a diagnostic history to be displayed. 


This parameter displays fault information for both units of the posted PM. 


This parameter causes the LTF counter to be reset to zero. 


Qualifications 


The querypm command is qualified by the following exceptions, 
restrictions, and limitations. 


e Other fault conditions are: 
- Init-A CC restart has occurred. RTS is attempting during restart. 
- Diagnostics Failed-The unit has failed TST or RTS. 


- Trap-The unit has sent an “initialization complete” message to the 
CC after an auto-restart. 


- Activity Dropped-A system-generated SwAct has occurred. 
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querypm (continued) 


- Audit-The internal software state of the active or inactive unit is 
incorrect. The active unit internal state should be RUNNING. The 
inactive unit internal state should be READY. Fault indications are: 
BUSY, RESTART, or SYNCING. 

- Unsolicited Message Limit Exceeded-The unit has sent more than 
100 unsolicited messages to CC within 1 minute. 

- CS Links-The CS message links have failed the periodic in-service 
C-side links test (which occurs once per minute). 

e The following logs are generated when the indicated maintenance 
actions occur: 

- PM128-The NT6X78 CMR card is out-of-service. Until the card is 
returned to service or replaced, the XPM cannot be returned to 
service or tested by in-service tests. 

- PM180-The NT6X78 CMR card has a faults and a reset has been or 
is being attempted. 

- PM181-The NT6X78 CMR card has failed a card test and therefore 
has caused the XPM to have in-service trouble (ISTb). 

- PM601-When a querypm diaghist reset command is issued, a 
summary of LTF counters is recorded in a PM106 log before LTF 
counter is reset. 


e Two sets of counters are used to save information for the diaghist 
parameter function, long term failures (LTF) and short term failures 
(STF). 


e Whenever the queypm diaghist reset command is executed a warning is 
issued indicating the LTF counter data collected for the posted PM will 
be lost. 


e The following diagnostics are supported by the AF5006 feature and may 
be reported in a diagnostic history. 


AB DIAG A/B Bits solicited 
AMUDIAG 6X50 External Loop solicited 
CDS1 DG CSide DS1 solicited 
CMRDIAG CMR CardO both 


CONT DG Continuity Diag solicited 
CSMDIAG CSM Diag solicited 
CS SPCH Network Links solicited 
DCHIALB DCH Inactive Loopback solicited 
DS1DIAG PSide DS1 solicited 
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Diag name Description Type (solicited | Required by 
or audit) SwAct controller 


DS30A 
FORMATR 
ISPHDLC 
ISPSPHI 
ISPSPHF 
MSGDIAG 
MSG IMC 
MX76MSG 
PADRING 
PARITY 
PS LOOP 
PS SPCH 
RCC FMT 
SCM AB 
SCM MSG 
SPCH DG 
STRDIAG 
SYNC DG 
FAC AUD 
TONE DG 
TS DIAG 
UTRDIAG 


6X48 / MX74 Audit audit 

Local Formatter solicited 
ISP HDLC Diag solicited 
ISP Speech Bus Internal solicited 
ISP Speech Bus Full solicited 
6X69 Messaging Card solicited 
IMC Link both 

MX76 Messaging Card solicited 
6X80 Pad/Ring solicited 
Parity Audit audit 

PSide Loops solicited 
PSide Speech Links solicited 
Remote Formatter solicited 
6X81 A/B Bits solicited 
SCM A/B DDL Msg solicited 
Speech Path solicited 
Special Tone Receiver solicited 
Sync Diag both 

Facility Audit audit 

Tone Diag both 

Time Switch Diag solicited 
UTR Card solicited 


e The following cards are supported by the AF5006 feature and may be 
reported in a diagnostic history. 


NT6X40 
NT6X41 
NT6X42 
NT6X44 
NT6X45 
NT6X46 
NT6X47 
NT6X48 


Net Interface Link 

Speech Bus Formatter and Clock 
CSM 

Timeswitch and A/B Bit Logic 
Master/Signalling/File Processor 


SP Memory 
MP Memory 
DS30A Interface 
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querypm (continued) 


NT6X50 DS1 Interface 

NT6X55 DSO Interface 

NT6X62 STR Card 

NT6X69 Messaging Card 

NT6X70 Continuity Card 

NT6X72 RCC Host Link Formatter 
NT6X78 CLASS Modem Resource (CMR) 
NT6X79 Tone Generator 

NT6X80 SCM Pad/Padring 

NT6X81 SCM AB Bit 

NT6X85 SCM DS1 

NT6X86 SCM MSG 

NT6X92 Universal Tone Receiver (UTR) 
NT8X18 SMSR CSide DS30A Interface 
NTBX01 ISDN Signalling Processor (ISP) 
NTBX02 DCH 

NTMX76 CSM + MSG Card 

NTMX77 68020 Processor (UP) 
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querypm (continued) 


Examples 
The following table provides examples of the querypm command. 


Examples of the querypm command 


Example Task, response, and explanation 


querypm . 


Task: Display information about the currently posted DTC. 


Response: 

PM Type: DTC PM No.: 0 PM Int. No.: 0 Node_no.:31 

PMs Equipped: 51 Loadname: NLG36BL 

WARM SWACT is supported and available. 

DTC 0 is included in the REX schedule. 

REX on DTC 0 has not been performed. 

Node Status: (OK, FALSE) 

Unit 0 Inact, Status: (OK, FALSE} 

Unit 1 Act, Status: (OK, FALXE) 
Site Flr RPos Bay_id Shf Description Slot 
HOST 01 E31 LTE 00 51 DTC : 000 


Explanation: Typical display for querypm command. 
querypm fit 


Task: Display fault information for both units of the posted PM. 


Response: Node is ISTb 

One or both Units inservice trouble 

Unit 0 
The following inservice troubles exist: 
PM Load mismatch with Inventory table 
Unti 1 
The following inservice troubles exist: 
PM Load mismatch with Inventory table 


Explanation: Typical display for querypm flt command. 
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Examples of the querypm command (continued) 


Example Task, response, and explanation 
querypm diaghist .. 


Task: Display the diagnostic history for the posted PM. 


Response: 
DTC 1 Long-Term Failure (LTF) last reset: 92/07/01 03:12:14 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/03 03:10:23 
Last diagnostic failure: 92/07/04 13:35:50 
DIAGLIST CARDLIST STF LTF 
AB DIAG: Total failures 2 3 
NT6X44 0 3 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/01 03:12:14 
Last diagnostic failure: 92/06/02 14:00:31 
DIAGLIST CARDLIST STF L 
AB DIAG: Total failures 
NT6X44 
SPCH DG: Total failures 
NT6X44 
NT6X41 
NT6X43 


Explanation: Unit 0 has failures of the AB diagnostic while unit one has failures 
for both the AB and speech path diagnostics. 


querypm diaghist diag - 


Task: Display the diagnostic history for the posted PM, diagnostics only. 


Response: 
DTC 1 Long-Term Failure (LTF) last reset: 92/07/01 03:12:14 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/03 03:10:23 
Last diagnostic failure: 92/07/04 13:35:50 
DIAGLIST STF LTF 
AB DIAG: Total failures 2 3 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/01 03:12:14 
Last diagnostic failure: 92/06/02 14:00:31 
DIAGLIST STF LTF 
AB DIAG: Total failures 1 1 
SPCH DG: Total failures T 4 


Explanation: Unit 0 has failures of the AB diagnostic while unit one has failures 
for both the AB and SPEECH diagnostics. Only diagnostics are 
displayed. 
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Examples of the querypm command (continued) 


Example Task, response, and explanation 


querypm diaghist card — 


Task: Display the diagnostic history for the posted PM, card lists only. 


Response: 
DTC 1 Long-Term Failure (LTF) last reset: 92/07/01 03:12:14 
UNIT 0 Short-Term Failure (STF) last reset: 92/07/03 03:10:23 
Last diagnostic failure: 92/07/04 13:35:50 
CARDLIST STF LTF 
: NT6X44 0 3 
UNIT 1 Short-Term Failure (STF) last reset: 92/07/01 03:12:14 
Last diagnostic failure: 92/06/02 14:00:31 
CARDLIST STF 
: NT6X44 0 
: NT6X41 0 
: NT6X43 0 


Explanation: Unit 0 has one failing card and unit one has three failing cards. 
Card lists only are displayed. 
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Responses 
The following table describes the meaning and significance of responses to 


the querypm command. 


Responses for the querypm command 
MAP output Meaning and action 
Diagnostic History is not supported for this PM type 


Meaning: The querypm diaghist command was issued for a PM or XPM not 
supported by AF5006 feature. 


Action: None 


LTF counters reset to zero 


Meaning: This response indicates that yes was entered to the confirmation request 
for the querypm diaghist reset command. 


Action: None 


WARNING: The Long Term Failure (LTF) counters will be ZEROed. 
Please confirm (“YES”, “Y”, “NO”, OR “N”): 


Meaning: The warning and confirmation request are always issued when the 
querypm diaghist reset command is executed. 


Action: Enter yes to continue resetting the LTF counter, or enter no to abort the 
command. 
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Responses for the querypm command (continued) 


MAP output Meaning and action 


PM TYPE: type PM NO.: nnn PM INT.#: n NODE NO.: nnnn 
PMS EQUIPPED: xxx LOADNAME: 1_name 

WARM SWACT IS SUPPORTED 

status info 

LAST REX DATE WAS day mmdd AT hh.mm; results 

NODE STATUS: (OK, FALSE) 

UNIT 0 STATUS: (status, FALSE} 

UNIT 1 STATUS: (status, FALSE) 

SITE FLR RPOS BAY_ID SHF DESCRIPTION SLOT EQPEC 


Meaning: PM information is displayed, where: 


type is a PM type. 

nnn is 0-127 for the discrimination number of the PM type. 

n is a software internal number 

nnnn is 0-2047 for the PM node number of PM number nnn. 

|_name is the name of the load file for the PM type. 

status info is a reason for the status of a unit or node, where status_info can 
be: 


6X45 PEC MISMATCH BETWEEN INVENTORY TABLE & PM 

The mismatch means the datafilled entry in the inventory table does not 
match the PEC ofthe NT6X45 card. Check the PECs of the NT6X45 
cards in use by entering querypm or by inspecting the card and ensure that 
the PEC with the lowest suffix is the one datafilled in Table DTCINV. 


NOT LOADED SINCE POWER UP 


The DTC has not been loaded with software after having been powered up. 
The fault query of the NT6X45 card indicates the need for a load. The 
system tries to auto-load the units before a return to service. If 
auto-loading fails, the XPM must be manually busied and loaded (by the 
commands bsy and loadpm respectively). 


type nnn IS INCLUDED IN THE REX SCHEDULE 


The PM is automatically scheduled for REX testing by the system. 
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Responses for the querypm command (continued) 


MAP output Meaning and action 


day is an abbreviation for the day of the week, for example, MON for 
Monday. 

mmdd is an abbreviation for the month and includes the date of the day, 
for example, SEPO7 for September 7. 

hh.mm denotes the time in hours and minutes that the REX test occurred 

results gives the result of the last REX test (PASSED or FAILED) 

status is one of the PM status codes. 

SITE begins the header string which identifies the location of a circuit 
according to the standard scheme. 

card_list is the list of potentially faulty cards. 


Action: None 


NODE IS <status> 
<reason> 

UNIT 0 
state 

UNIT 1 
state 


Meaning: PM fault information is displayed, where: 


<status> is one of the PM status codes. 
<reason> is one or more of the following: 


CLASS MODEM RESOURCE CARD 6X78AA OUT OF SERVICE 
means the CMR NT6X78 card in the DTC is a cause of the XPM 
having in-service trouble (ISTb status). 


DATA NOT UP TO DATE 
DISTRIBUTED DATA MISMATCH 


NODE REDUNDANCY LOST (A UNIT IS OOS) means that one 
unit is out-of-service (OOS) and that SwAct cannot be done. For 
unit1, there has been a recent SwAct and the inactive unit is still 
SysB. The fault condition is caused by one unit being 
out-of-service. 
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Responses for the querypm command (continued) 


MAP output Meaning and action 


ONE OR BOTH UNITS INSERVICE TROUBLE 
NON-CRITICAL HARDWARE FAULT 


means there is a fault with the NT6X69 card of the posted XPM. 
The XPM has been made ISTb because the IMC link between the 
units is faulty and the CC hasclosed the link. See Testing the IMC 
link on page 37 for details. 


NOT LOADED SINCE POWER-UP 

means the DTC has not been loaded with software after having 
been powered up. The query of the NT6X45 card indicates the 
need for a load. The system tries to auto-load the units before a 
return-to-service. If auto-loading fails, the XPM must be manually 
busied and loaded (by the commands bsy and loadpm 
respectively). 


PSIDE LINKS OUT-OF-SERVICE 
RESET 


WARMSWACT DISABLED: 
DATASYNC FAILURE OR TURNED OFF 


means the node has exhibited ISTb trouble because either 
dynamic data sync has failed or turned off through RTS of the 
inactive unit with NODATASYNC option. 


MISMATCH FOUND IN NODE TABLE 

BETWEEN TWO XPM UNITS 

means a mismatch was found between the node tables of the two 
units after the inactive unit was returned to service. Clear the 
trouble as soon as possible since warm SwAct capability is 
disabled because of the above node ISTb reason. 


is one of 


NO FAULT EXISTS 

NOT status OR status 

status 

SYSTEM BUSY REASON: XPM SWACT ACTION 
REX failed 


Action: None 
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querypm (continued) 


Responses for the querypm command (continued) 


MAP output Meaning and action 


SYSTEM BUSY REASON: HARD PARITY FAULT WAS EXECUTED 


Meaning: The XPM unit was put to OOS state because to a hard parity fault. 


Action: Perform a ROM diagnostic to locate the faulty memory card. Replace 
the appropriate memory card, reload and RTS the faulty unit. Continue 
monitoring for recurrence. 


SYSTEM BUSY REASON: SOFT PARITY FAULT WAS DETECTED IN ps_ds 
Meaning: The XPM unit was put to OOS state because to the detection of a soft 
parity fault in either program store or data store in MP, SP, EP, or FP 
memory. 


Action: None 


SYSTEM BUSY REASON: INTERMITTENT PARITY FAULT WAS DETECTED 
Meaning: The XPM unit was put to OOS state because of the detection of an 
intermittent fault in MP, SP, EP, or FP memory. The system will RTS the 
faulty unit with new static data. 


Action: None 


THE FOLLOWING INSERVICE TROUBLES EXIST: 
INTERMITTENT PARITY FAULT WAS DETECTED IN xx MEMORY 


Meaning: The XPM unit went ISTb because of an intermittent fault in MP, SP, or 
FP memory, where xx indicates what processor contains the faulty 
memory. Busy and RTS the faulty unit. Continue monitoring for 
recurrence. 


Action: None 


THE FOLLOWING INSERVICE TROUBLES EXIST: 
HARD PARITY FAULT WAS DETECTED IN xx MEMORY 


Meaning: The XPM unit went ISTb because of a hard parity fault in MP, SP, FP, or 
EP memory, where xx indicates what processor contains the faulty 
memory. Busy the faulty unit. Perform a ROM diagnostic to locate the 
faulty memory card. Replace the appropriate memory card, reload and 
RTS the faulty unit. Continue monitoring for recurrence 


Action: None 
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Responses for the querypm command (continued) 


MAP output Meaning and action 


UNSOLICITED MSG LIMIT = ttt, UNIT O = nnn, UNIT 1 
UNIT 0 
count_info 
UNIT 1 
count_info 
MP: available_pec SP: available_pec 


Meaning: PM counter information is displayed where: 


ttt is the threshold limit for the number of unsolicited messages from 
the CC. If the threshold is reached, the PM may cancel calls in 
progress. 


is the number of unsolicited messages that have accumulated for 
each unit. 


count_info is one of 
RAM LOAD: | name1 
ROM LOAD: |_name2 


or 

FAILED TO READ COUNTERS 
or 

nnn 


where: 

| namel is the name of the load file for the unit, 

| name 2 is the firmware load file in the PM, and nnn is the count. The 
counters cannot be read because the respective unit is 
out-of-service. 


available_pec for an in-service unit, is a list of the available PECs of the 
equipped NT6X45 cards. MP indicates the master processor card 
while SP indicates the signaling processor card. If a question 
mark (?) is present instead of a PEC, the PEC can only be 
obtained by inspecting the appropriate card. 


Action: None 
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Responses for the querypm command (continued) 


MAP output Meaning and action 


<PMID> Long-Term Failure (LTF) last reset : <yr-month-day> <hr:min:sec> 
UNIT 0 Short-Term Failure (STF) last reset: <yr-month-day> <hr:min:sec> 
Last diagnostic failure: <yr-month-day> <hr:min:sec> 
DIAGLIST CARDLIST STF LTF 
<diag_name> <card list> <counts> <counts> 


<diag_name> <card list> <counts> <counts> 
UNIT 1 Short-Term Failure (STF) last reset: <yr-month-day> <hr:min:sec> 
Last diagnostic failure: <yr-month-day> <hr:min:sec> 
DIAGLIST CARDLIST STF LTF 
<diag_name> <card list> <counts> <counts> 


<diag_name> <card list> <counts> <counts> 


Meaning: This is the response to a querypm diaghist command, where 


<PMID> is the type of PM such as DTC, DTC, or RCC 
<yr-month-day> year, month and day 

<hr:min:sec> hour, minute and second 

<diag_name> the name of the diagnostic test 

<card list> the PEC for a spcific card 


-  <counts> the number of short term or long term failures 
Action: None 
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quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DTC level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DTC level has changed to the previous menu level. 
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quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DTC level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DTC level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DTC level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DTC level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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recover 


Function 
Use the recover command to reload and return to service one unit of a set of 
DTCs that has lost its memory of the load when the system requires 
powering up. 


recover command parameters and variables 


Command Parameters and variables 


recover | Posted If wait ] 
all nowait 


Parameters 
and variables Description 


This parameter simultaneously recovers all of the XPMs of the same type as the 
XPM in the current position of the posted set. 


This parameter allows the recovery to proceed without waiting for confirmation fro 
the system. The parameter nowait enables the MAP to be used for other 
maintenance commands while the recovery is in progress. 


posted This default parameter, which is never entered, indicates that only the currently 
posted DTC will be affected by the recover command because the all parameter ig 
not entered. 


This default parameter, which is never entered, indicates that the user must wait fgr 
the recover command to complete executing before entering additional commands 
at the MAP because the nowait parameter is not entered. 


Qualifications 


The recover command is qualified by the following exceptions, restrictions, 
and limitations: 


e The XPMs must be either the manual busy (ManB) or the system busy 
(SysB) state. 

e If table PMLOADS is not correctly datafilled loading with the recover 
command cannot occur. 

e The recover command overrides any system action that is still in 
progress. 


e The recover command makes only one attempt to recover XPMs in a 
posted set. For XPMs that are not recovered, manual action is required 
to reload and return them to service. 


e Loading and returning to service can occur simultaneously on different 
PMs of the same PM type. 
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recover (continued) 


Example 


The following table provides an example of the recover command. 


Example of the recover command 


Example 


recover .| 


Responses 


Task, response, and explanation 


Task: Reload and return to service the posted DTC. 
Response: DTC 0 PASSED 


Explanation: The posted DTC has been reloaded and returned to service. 


The following table describes the meaning and significance of responses to 
the recover command. 


Note: All responses to the commands loadpm and rts for the respective PM 
type in the posted set also apply to the command recover. Other responses 
are described alphabetically as follows. 


Responses for the recover command 


MAP output 


Meaning and action 


<pm_type> <pm_number> FAILED 


<reason> 
or 


<pm_type> <pm_number> PASSED 


Meaning: These are the results of the loading. Ifthe loading succeeds on at least 
one unit, a return to service is attempted on the PM. 


Action: None 


<pm_type> <pm_number> RECOVER FAILED 


<reason> 
or 


<pm_type> <pm_number> RECOVER PASSED 


Meaning: These are the results of the return to service. 


Action: None 
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recover (end) 
Responses for the recover command (continued) 


MAP output Meaning and action 


<pm_type> <pm_number> RTS REQUEST SUBMITTED 


Meaning: The PM is not equipped with the BA or later version of the NT6X45 
Firmware card. Reloading is not attempted. 


Action: None 


<pm_type> <pm_number> UNIT <u> RECOVER FAILED 


REQUIRE LOAD BUT NOT ATTEMPTED FOR SINGLE UNIT 


Meaning: The unit must be reloaded, but its mate failed the test for load sanity. 


Both units must be available for broadcast loading to occur, therefore no 
further action is done to this XPM. 


Action: Use the command loadpm on the identified PM. 


<pm_type> <pm> UNIT <u> RELOADING REQUIRED. RTS ATTEMPTED ON MATE 
Meaning: The identified unit cannot be reloaded. The mate unit has been 


successfully loaded; therefore the system is returning it to service 
instead. 


Action: None 
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rts 


Function 
Use the rts command to return to service one or all DTCs in a posted set, or 
one P-side link of the DTC in the control position of the posted set. Tests 
are done and a return to service occurs if the tests succeed. Each unit must 
be in the ManB or SysB state. 


rts command parameters and variables 


Command Parameters and variables 


unit no  [datasync |[notcmr || noforce | [wgit [posted 
nodatasync | |cmr force nowait all 


inactive Eas | 
nodatasync 

link ps_link 

sysb 


Parameters 
and variables Description 


active This parameter returns to service one or all of the units in the active state. 
all This parameter returns to service all posted PMs, regardless of status. 
cmr This parameter returns to service the class modem resource (CMR) card. 


datasync This default parameter, which is never entered, indicates that the PM will attempt 
data sync after RTS because the nodatasync parameter is not entered. 


force This parameter bypasses pre-rts test routines. It overrides all other commands that 
may be in effect on a unit unless maintenance actions are already in progress. 


inactive This parameter returns to service one or all units in the inactive state. 


link This parameter returns to service a specified P-side link between the posted DTC 
and one of its associated LCMs. 


notcmr This default parameter, which is never entered, indicates that the CMR card is not 
being returned to service because the cmr parameter is not entered. 


nodatasync This parameter causes static data to be sent to the inactive unit, but the PM will ngt 
attempt data sync after RTS. 
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rts (continued) 


rts command parameters and variables (continued) 


Parameters 
and variables Description 


This default parameter, which is never entered, indicates that pre-rts tests will be 


run, and if there are failures, rts will not occur, because the force parameter was n 
entered. 


This parameter allows other maintenance commands to be entered before rts co 
mand is completed. 


This parameter returns to service both units of one or all posted DTCs. 


posted This default parameter, which is never entered, indicates that only the currently 
posted DTC will be returned to service, because the all parameter was not entered. 


ps_link This variable specifies which P-side link is to be returned to service. The range is 
0-19. 


sysb This parameter returns all posted system busy PMs to service. 
unit This parameter returns to service one unit of one or all posted DTCs. 


unit_no This variable specifies which unit of the posted DTCs is to be returned to service. 
The range is 0-1. 


wait This default parameter, which is never entered, indicates that the user must wait 
until the rts command has executed before entering additional commands at the 
MAP because the nowait parameter was not entered. 


Qualifications 
The rts command is qualified by the following exceptions, restrictions, and 
limitations. 
e When an XPM is made system busy (SysB state), the testing and loading 
of a return to service are automatically initiated. 


e The nodatasync parameter does not apply to PMs equipped with a small 
load. 


e If the UNIT, PM, or LINK is CBsy, RTS is executed without any testing 
and the status becomes CBsy. 


e When the active unit of the DTC is returned to service, all P-side links 
are set to SysB, and then to RTS with a test performed on each link as it 
passes the test, unless the links are ManB. 
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rts (continued) 


While the status of one PM is displayed, the responses indicate the test 
initiations and results for the other PMs of the posted set. The 
discrimination number of the displayed PM does not change. 


As PMs are returned to service, the PM status display decrements under 
the header ManB and increments under ISTb or InSv. If the return to 
service fails, the header ManB decrements and either header CBsy or 
SysB increments by 1 for each posted PM. 


While PMs are tested and returned to service, the status display of the 
posted PM in the control position changes the maintenance flag (Mtce) 
beside the unit’s status, and by the progression of the tests beside the 
header RG. Tests occur, one unit at a time, and progression is shown by 
a series of messages displayed in the following order: 

Initializing 

Reset 

Status 

Run 

Reset 

Run 

If the NT6X78 CMR card fails the tests during an attempt to return the 

PM to service, the PM cannot be returned to service until the card is 

seated properly or replaced. 

The force parameter should not be used on the DTC when the NT6X78 

CMR card is present. If the card is in the process of initializing itself 

while the XPM is returning to service, the XPM remains in the manual 

busy (ManB) or system (SysB) state. The return to service must be 
repeated when the CMR is initialized. 

The following logs are generated when the indicated maintenance 

actions occur: 

- PM128-The NT6X78 CMR card is out of service. Until the card is 
returned to service or replaced, the XPM cannot be returned to 
service. 

- PM180-The NT6X78 CMR card has a fault and a reset has been or 
1s being attempted. The return to service has not occurred. 

- PM181-The NT6X78 CMR card has failed a card test and therefore 
cannot be returned to service. 


- PM184-A P-side link is returned to service. 
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rts (continued) 


Example 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 
rts pm. 


Task: Return the posted DTC to service. 
Response: OK 


Explanation: The posted DTC has been returned to service. 


Responses 


The following table describes the meaning and significance of responses to 
the rts command. 


Responses for the rts command 
MAP output Meaning and action 


6X45 PEC MISMATCH 
available_pecs 


Meaning: The return to service cannot occur because the datafilled entry in the 
inventory table does not match the PEC of the NT6X45 card. If 
parameter nowait is entered, this response does not appear. 


Action: SYSTEM: While the table query is occurring, the maintenance flag 
ROM/RAM QUERY is displayed. 


The equipped PECs of NT6X45 cards are listed, where available_pecs 
is one or more card(s). If a question mark (?) is present instead of a 
PEC, the PEC can only be obtained by inspecting the appropriate card. 


USER: Check the PECs of the NT6X45 cards in use and ensure that 
the one with the lowest suffix is the one datafilled in inventory Table 
DTCINV. 
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rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 
ALL OPTION NOT SUPPORTED FOR LINK PARAMETER 


Meaning: The parameter all does not apply to links because they must be returned 
to service one at a time. 


Action: None 


/CLEAR DATA 


Meaning: With feature package NTX270, DTCs do not undergo the second restart 
for command rts that other XPMs undergo. Therefore, the resetting of 
the Static Data occurs before the initial restart, and the system confirms 
that the Static Data is reset (cleared). 


None 


FAILED TO SEND RESET MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, returning to service cannot 
occur because a card is not reset. The card is one or more of the listed 
cards, where card _list is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 
NT6X72 


Action: None 
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rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, returning to service cannot 
occur because a card is not communicating. The card is one or more of 
the listed cards, where card_list is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X69 


Action: None 
INACTIVE PARAMETER NOT VALID FOR OOS PM 


Meaning: The parameter inactive does not apply to out-of-service XPMs. The 
XPM(s) must be in service. 


Action: SYSTEM: The activity display for the XPM(s) is blank. 


USER: To return the XPM(s) to service, re-enter the command rts with 
the parameter unit or pm. 


DTC pm_number MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTC cannot be returned to service because it is already undergoing 
maintenance action, where pm_number is the discrimination number of 
the DTC. 


Action: SYSTEM: With parameter all, the DTC is bypassed from the posted set 
of XPMs only for the duration of the return to service. 
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rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


DTC pm_number REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With the all parameter, an DTC in the posted set cannot be returned to 
service because it is not in the manually busy state. 


Action: SYSTEM: The DTC in the posted set is bypassed by the return to 
service. 


USER: To proceed with the maintenance, wait until the action on the 
posted set is completed, then busy the DTC with the bsy command 
before trying the command rts. 

DTC pm_number UNIT u RTS PASSED 


Meaning: The tests are confirmed, where pm_number and u echo the 
discrimination numbers of the DTC and its unit. 


Action: SYSTEM: The DTC or unit is made InSv. 


NO RESPONSE FROM PM AFTER ROMTEST 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, a return to service cannot 
occur because a card is not communicating. The card is one or more of 
the listed cards, where card_list is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 


Action: None 
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rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


NO RESPONSE FROM PM AFTER STATUS 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, a return to service cannot 
occur because a card is not communicating. The card is one or more of 
the listed cards, where card_list is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 

NT6X69 


Action: None 


NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


Meaning: The return to service cannot occur because the datafilled entry in the 
inventory table does not match the PEC of the NT6X45 card or because 
the ROM/RAM query is not replied to. If nowait parameter is specified, 
this response does not appear. 


SYSTEM: The maintenance flag ROM/RAM QUERY appears while the 
load is being queried. 


USER: Check the PECs of the NT6X45 cards in use and ensure that 
the one with the lowest suffix is the one datafilled in Table DTCINV. 
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rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


NO WAI RECEIVED AFTER RESET 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not present. The card is one or more of the listed 
cards, where card _list is one of 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 
NT6X45 (SP) 

NT6X46 

NT6X46 (FP, memory) 
NT6X47 

NT6X50 

NT6X69 

NT6X72 


Action: None 
OPERATIONS ON TRUNK CARRIERS MUST BE DONE AT CARRIER MAP LEVEL 


Meaning: With the link command, there are two kinds of connections to the RLCM: 
links or trunks. The trunks are operated from the CARRIER level. 


Action: Use the command trnsl to display which ps_link assignment is a link and 
which is a trunk. 


Meaning: The test passes and the PM is returned to service. 


Action: None 


OSVCE TEST INITIATED 


Meaning: Out-of-service testing is being performed on the posted PM. 


Action: None 
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rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


PM FAILED TO INITIALIZE 
TRY RELOADING THE PM 


Meaning: 


Action: 


PM IS OFFLINE 
NO ACTION TAKEN 


Meaning: 
Action: 
PM NOT LOADED SINCE 


Meaning: 


For XPMs with an NT6X69 messaging card, a return to service cannot 
occur because a card is not initialized. 


USER: Reload the XPM by entering the command pmreset or loadpm at 
the MAP. 


The command cannot be executed because the PM is in the Offl state. 


None 


POWER UP 


The DTC cannot be returned to service because it has not been loaded 
with software after having been powered up. If nowait parameter is 
entered, this response does not appear. 


Using the command querypm indicates which load for the NT6X45 card. 
the system tries to auto-load the units before a return to service. When 
auto-loading fails, the XPM must be manually busied and loaded (by the 
commands bsy and loadpm respectively). 


SYSTEM: The maintenance flag ROM/RAM QUERY appears while the 
load is being queried. 


Log PM181 records the occurrence of this response. 
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Responses for the rts command (continued) 


MAP output Meaning and action 


pm_type pm_number IS status. 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for returning to service, where pm_type 
is a PM listed in Table A on page 18, pm_number is the discrimination 
number of the PM , and status is one of 

CBSY 
INSV 
OFF-LINE 
The PM must be ManB. 
Action: None 


REPLACE CARDS IN CARDLIST 
card_list 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the return to service, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


REQUEST INVALID 
MSBx pm_number IS pm_state 


Meaning: By the command string rts pm force, the state of one of the MSB units 
that is connected to the DTC prevents the whole PM from being made in 
service. That is, one unit may be ISTb. The value of x is either 6 or 7 for 
the type of MSB. 

None 


RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Re-enter the command rts. 
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Responses for the rts command (continued) 
MAP output Meaning and action 
RTS FAILED 


TRY THE RTS COMMAND ON ONE UNIT 


Meaning: For XPMs with an NT6X69 messaging card, a return to service cannot 
occur because both units are ManB or a card is pulled. The unit(s) 
must be reloaded. 


Action: Uses the command rts to reload the static data into the unit(s). 


SUMMARY: 
nnn PASSED 
nnn NOT SUBMITTED 


Meaning: With parameter all, a summary is given of the quantity (nnn) of XPMs in 
the posted set that have been successfully returned to service or that 
have been bypassed by the return to service. 


Action: None 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EQPEC 
card_list 


Meaning: Results of test are displayed using the standard circuit display. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON nnn DTC 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Meaning: A quantity of nnn DTCs in the posted set is to be returned to service. 


Action: Enter YES to test, reload, and then return the DTC(s) to service. Enter 
NO to abort the action. 


**WARNING** UNIT u MAY NOT HAVE A VALID LOAD 


Meaning: A unit of a PM of node-type DTC has undergone the ROM tests, where u 
is either O or 1. The RAM load is erased. 


Action: Reload the unit using the command loadpm. 
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rts (end) 


Responses for the rts command (continued) 
MAP output Meaning and action 
STATIC DATA WILL BE SENT. DATA SYNC WILL NOT BE 


ATTEMPTED AFTER THE INACTIVE UNIT IS RTSED. 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”): 


Meaning: Whenever the nodatasync option is entered at the MAP and screened to 
be acceptable, the CC will warn the user on the impact of the option. 
The craftperson will also be prompted YES/NO before the rts command 
processing can proceed. If YES is entered, the CC will reset static data 
in the CPM and send down static data during the rts of the inactive unit. 
The PM will not attempt data sync after the inactive unit is returned to 
service. Warm SwAct is disabled. 


Action: None 
PM IS OOS, NODATASYNC PARM DOES NOT APPLY 
Meaning: The nodatasync option is rejected because the PM is not in service. 


Action: None 


PM IS EQUIPPED WITH SMALL LOAD. 
NODATASYNC PARM DOES NOT APPLY 


Meaning: The nodatasync command option is rejected because the PM is 
equipped with a small load. 


Action: None 
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Function 


Use the swact command to cause the posted DTCs to switch the activity of 
the pairs of units (unit-O and unit-1). The active unit is made inactive, the 
inactive unit is made active. Units O and 1 must be InSv or ManB. 


swact command parameters and variables 


Command Parameters and variables 


| posted noforce notnow notes! | 
all force now test 


Parameters 
and variables Description 


all This parameter simultaneously switches the activities of all DTCs (or all XPMs of 
the same node type as the XPM in the current position of the posted set). 


force This parameter overrides the SwAct decision of the SwAct controller and forces a 
SwAct to take place. 


noforce This default parameter, which is never entered, indicates that a SwAct will not be 
forced because the force parameter is not entered. 


notest This default parameter, which is never entered, indicates that the DTC will not un- 
dergo out-of-service (OOS) testing, because the test parameter is not entered. 


notnow This default parameter, which is never entered, indicates that an immediate SwAc 
will not be performed because the now parameter is not entered. 


now This parameter executes an immediate SwAct. 


posted This default parameter, which is never entered, indicates that only the currently 
posted DTC will be subject to the swact command, because the all parameter is n 
entered. 


This parameter causes a newly inactive unit to receive full OOS diagnostics when 
RTS occurs. 


Qualifications 
The swact command is qualified by the following exceptions, restrictions, 
and limitations: 
e If the DTC is not ManB, confirmation YES or NO is required. If the 
DTC is ManB no confirmation is required. 


e Log PM181 is generated when SwAct is executed, identifying the 
newly-active unit. This log is for information only and there is no alarm. 
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swact (continued) 


Examples 
The following table provides examples of the swact command. 


Examples of the swact command 


Example Task, response, and explanation 
swact .| 


Task: Perform a switch of activity on the posted DTC. 
Response: A Warm SwAct will be performed after 
data sync of active terminals. 


Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: When y is entered, a warm SwAct is executed unless refused by 
the SwAct controller. 


swact now test J 


Task: Switch the activity on the posted DTC immediately, and perform 
OOS diagnostics for the unit being returned to service. 


Response: A Warm SwAct will immediately be performed. 
and 1 active terminals may be affected. 
Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: When y is entered, a warm SwAct is executed and test performed 
unless refused by the SwAct controller. 


swact force — 


Task: Force a switch of activity on the posted DTC. 


Response: A warm SwAct will be performed after data 
sync of active terminals. 
Overriding the SwAct Controller. 
Please confirm (“YES”, “Y”, “NO”, or “N”): 


Explanation: When y is entered, a warm SwAct is executed even if it would be 
refused by the SwAct controller when the force parameter is not 
entered. 
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Responses 


The following table describes the meaning and significance of responses to 
the swact command. 


Responses for the swact command 


MAP output Meaning and action 


A Cold SwAct will be performed 

This action will take this PM 

temporarily out of service. 

This PM has at least one PSQ link 

and 0 active terminals may be affected. 
Please confirm (“YES”, “Y”, “NO”, OR “N”): 


Meaning: The DTC is not ManB and the unlisted menu command, warmswact, is 
off. During a cold SwAct, both units are SysB and call processing is lost 
until the active unit is returned to service. A cold SwAct drops all calls. 

Action: If YES is entered the response is 


DTC pm_number SwAct Passed 


which indicates SwAct is successful. 


A Warm SwAct will be performed after 
data sync of active terminals. 
Please confirm (“YES”, “Y”, “NO”, or “N”): 


Meaning: A swact command has been entered. When y is entered, a warm SwAct 
is executed unless refused by the SwAct controller. 


Action: If YES is entered the response is 
DTC pm_number SwAct Passed 


which indicates SwAct is successful. 
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D-924 DTC level commands 
swact (continued) 


Responses for the swact command (continued) 
MAP output Meaning and action 
A Warm SwAct will immediately be performed. 


1 active terminals may be affected. 
Please confirm (“YES”, “Y”, “NO”, or “N”): 


Meaning: A swact now command has been entered. When y is entered, a warm 
SwAct is executed and test performed unless refused by the SwAct 
controller. 

If YES is entered the response is 
DTC pm_number SwAct Passed 


which indicates SwAct is successful. 


A warm SwAct will be performed after data 
sync of active terminals. 

Overriding the Swact Controller. 

Please confirm (“YES”, “Y”, “NO”, or “N”): 


Meaning: When y is entered, a warm SwAct is executed even if it would be 
refused by the SwAct controller without the force parameter. 


Action: None 


A WARM SWACT WILL BE PERFORMED AFTER 

DATA SYNC OF ACTIVE TERMINALS 

THE INACTIVE UNIT MAY NOT BE CAPABLE OF GAINING 
ACTIVITY. (PLEASE CHECK LOGS). DO YOU WISH FOR THE 
SWACT TO CONTINUE, REGARDLESS? 

PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”): 


Meaning: The pre-SwAct audit has determined that the unit should not assume 
activity and the warm SwAct operation should be terminated. 


Action: The user is prompted to confirm or reject command execution. If the 
user confirms, the warm SwAct is carried out. If the user rejects the 
command, it is aborted. 


DTC 2 A WARM SWACT WILL BE PERFORMED 


Meaning: DTC 2 is to have the activity of its units switched. Calls in progress are 
allowed to complete. 


Action: None 
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DTC level commands D-925 
swact (continued) 


Responses for the swact command (continued) 


MAP output Meaning and action 

DTC 2 SWACT PASSED 
Meaning: The activity of the two DTC units is switched. 
Action: None 


REQUEST INVALID 
INACT UNIT MUST BE INSV OR BOTH UNITS MUST BE MANB 


Meaning: The units cannot be switched because one or both are in the wrong 
state. 


Action: None 


SWACT OPERATION NOT VALID ON OOS PM 


Meaning: When an XPM is in an out-of-service state (ManB, SysB, CBsy, or Offl), 
a SwAct cannot occur. 


Action: The activity display for the XPM(s) is blank. 
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DTC level commands D-926 
swact (end) 


Responses for the swact command (continued) 


MAP output Meaning and action 


SwAct refused by SwAct Controller 
Inactive unit has a history of: 
<history text> 
Inactive unit is reporting: 
<XPM text> 


Meaning: The swact command has be refused by the SwAct controller for the 
reason indicated. The refusal reason text may include either <history 
text>, <XPM text>, or both, where: 


<history text> is one of the following: 

- IMC link failures 

- Message link failures 

- Parity audit failures 

- Superframe sync failures 

- InActive unit was unable to keep activity last time 
- Dropping activity due to <autonomous drop reason> 
- PreSwAct query failure 

<XPM text> is one of the following: 

- Unit is jammed Inactive 

- Unit is in overload 

- Message link failure 


- Static data corruption 
- IMC link failure 
- PreSwAct difficulties 


Action: No action is required. If the user wishes to override the SwAct controller, 
the swact command may be reissued using the force parameter. 


297-1001-821 Standard 04.01 June 1999 
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trnsl 


Function 
Use the trnsl command to identify the C-side or P-side links of a posted 
DTC and show the status of the DS30 links to the network (C-side), or the 
DS30A or DS-1 links to the subsidiary PM (P-side). 


trnsl command parameters and variables 


Command Parameters and variables 


| allinks 
| link_no 


To j 
LP 

Parameters 

and variables Description 


This default parameter, which is never entered, indicates all the links on the se- 
lected side or sides to be affected by the command because no /ink_no is specified. 


This parameter selects the C-side links. 


This parameter selects the P-side links. 


This variable identifies one link for the C-side. The range is 0-31. This variable algo 
identifies one link for the P-side. The range is 0-19 . If /ink_no is omitted, all the 
C-side or P-side links are displayed. 


This parameter specifies all the message links of the C- or P-sides of the DTC. 


Qualifications 
None 
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D-928 DTC level commands 
trnsl (continued) 


Examples 
The following table provides an example of the trnsl command. 


Examples of the trnsl command (continued) 


Example Task, response, and explanation 


identifies the C-side links of the posted DTC. 


Task: Identify the C-side links and show the status of the DS30 links to the 
network. 


Response: 


¿NETO 
:NET1 


LINK 0 O 10;CAP MS;STATUS:OK ;MSGCOND:OPN, Unrestricted 
LINK 1 0 10;CAP MS;STATUS:MBsy;MSGCOND:CLS, Unrestricted 
LINK 2:NETO O 11;CAP MS;STATUS:OK ; 
LINK 3:NET1 O 11;CAP MS;STATUS:MBsy; 
LINK 4:NETO 1 52;CAP MS;STATUS:OK ;MSGCOND:OPN, Unrestricted 
LINK 5:NET1 1 52;CAP MS;STATUS:OK ;MSGCOND:CLS, Unrestricted 


Explanation:|n this example, there are four DS30 links (0-3) to NM-O and two 
links (4,5) to NM-1. DTC-0 has been selected. 


trnsl pu 
where 


p identifies the P-side links of the posted DTC. 


Task: Identify the P-side links and show the status of the DS30A or DS-1 
links to a subsidiary PM. 


Response: 


LINK 0:LCM 0;CAP MS;STATUS:OK ;MSGCOND: 
LINK 21 1;CAP MS;STATUS:MBsy;MSGCOND: 
LINK ale 2;CAP S;STATUS:OK ;MSGCOND: 
LINK 3:1] 0;CAP MS;STATUS:MBsy;MSGCOND: 
LINK : LCM 1;CAP MS; STATUS:OK 


Explanation:In this example, there are three (0-2) DS30A links to LCM-0, and two 
links (3,4) to LCM-1. DTC-0 has been selected. 
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DTC level commands D-929 
trnsl (end) 
Response 


The following table describes the meaning and significance of the response 
to the trnsl command. 


Response for the trnsl command 


MAP output Meaning and action 


PM HAS NO PSIDE INFORMATION 


Meaning: The P-side parameter has been specified for a PM that has no 
associated P-side links. 


Action: None 
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DTC levelcommands D-931 
tst 


Function 


Use the tst command to test one or all units of one or all posted DTCs, or to 
test one specified P-side link. 


tst command parameters and variables 


Command Parameters and variables 


ps_link 


unit_no 


wait 
| nowait 


Parameters 
and variables Description 


This default parameter causes all tests to be performed when neither the cmr nor 
rom parameter is entered. 


This parameter tests the cmr card in the selected unit of the posted DTC. 


This parameter applies the test to a specified P-side link between the posted DTC 
and one of its associated LCMs, RLCMs or RCCs. 


This parameter performs a manual REX test. The nowait parameter used with thig 
command returns control to the MAP terminal, suppressing messages and allowinp 
commands to be entered before the REX testing is completed. 


This parameter causes the posted DTC to be removed form the system REX schep- 
ule. 


This parameter causes the posted DTC to be included in the system REX schedulp. 
This variable specifies which of the P-side links is to be tested. The range is 0-63 


This parameter tests both units of one or all posted DTCs, first unit 0, then unit 1. 


This parameter displays the REX maintenance record for the posted DTC. 
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D-932 DTC level commands 
tst (continued) 


tst command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter enables rex testing to be scheduled, unscheduled or performed i 
mediately for the posted DTC. 


rom This parameter tests the ROM for the posted DTC or specified unit. 


unit This parameter tests one unit of the posted DTC and must be followed by the unit 
number. 


unit_no This variable specifies which unit of the posted DTC is to be tested. The range 
is 0-1. 


wait This default parameter, which is never entered, indicates that the user must wait 
until the command has executed before additional commands can be entered at the 
MAP. 


Qualifications 


The tst command is qualified by the following exceptions, restrictions, and 
limitations: 


e The node under test must be InSv, ISTb, ManB, or SysB. 


e Ifthe DTC is ManB, the full test is preceded by a message looparound 
pilot test. 


e Units that have been tested by parameter ROM must be manually 
reloaded before being returned to service. 


e During the progress of maintenance testing, Mtce appears on the display 
beside the respective units. 

e When the warm swact command is disabled for an XPM, a REX test in 
progress still allows the commands bsy, tst, and rts to be entered for the 
inactive unit. However, if the warm swact command is disabled before 
the REX test starts, and because the inactive unit must be in service. the 
test cannot be run. The command string tst rex now cannot be used. 


e The CMR card must be busied before it can be tested. 


e The following logs are generated when the indicated maintenance 
actions occur: 


- PM128-The NT6X78 CMR card is out-of-service. Until the card is 
returned to service or replaced, the XPM cannot be tested by the 
in-service tests of the tst command. 
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DTC levelcommands D-933 


tst (continued) 


- PM180-The NT6X78 CMR card has a fault and a reset has been or 


is being attempted. Testing has not occurred. 


- PM181-The NT6X78 CMR card has failed a card test. 
e The following diagnostics are supported by the AF5008 REX control 


feature. 


Diagnostic Description Type (solicited | Required by 
name or audit) SwAct controller 


ISPHDLC 
ISPSPHI 
ISPSPHF 
MSGDIAG 
MSG IMC 
MX76MSG 
PADRING 
PARITY 
PS LOOP 
PS SPCH 
RCC FMT 
SMS AB 
SMS MSG 
SPCH DG 
STRDIAG 
SYNC DG 
TONE DG 
TS DIAG 
UTRDIAG 


ISP HDLC Diag 

ISP Speech Bus Internal 
ISP Speech Bus Full 
6X69 Messaging Card 
IMC Link 

MX76 Messaging Card 
6X80 Pad/Ring 

Parity Audit 

PSide Loops 

PSide Speech Links 
Remote Formatter 
6X81 A/B Bits 

SCM A/B DDL Msg 
Speech Path 

Special Tone Receiver 
Sync Diag 

Tone Diag 


Time Switch Diag 
UTR Card 


solicited 
solicited 
solicited 
solicited 
both 
solicited 
solicited 
audit 
solicited 
solicited 
solicited 
solicited 
solicited 
solicited 
solicited 
both 
both 
solicited 
solicited 
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D-934 DTC level commands 
tst (continued) 


Examples 
The following table provides examples of the tst command. 


Examples of the tst command 


Example Task, response, and explanation 


tst unit 0 — 
where 


0 is the unit of the DTC to be tested. 
Task: Test unit 0 of the posted DTC. 
Response: Tst Passed 


Explanation: Test of unit 0 of the posted DTC passed. 


bsy unit 0 cmr | 
tst unit 0 cmr J 
where 


0 is the unit ofthe DTC to be tested. 


Task: Test the CMR card in unit 0 of the posted DTC. 


Response: CMR Tst Passes 


Explanation: Testthe CMR card in unit O of the posted DTC passed. 


tst rex query J 
Task: Display a record of REX maintenance. 


Response: 

DTC 0 is included in REX schedule. 

Last REX date was THU. 1992/06/20 at 09:53:57; FAILED. 
REX test Failed - OOS tests of Inactive Unit 1 
Diagnostic Failures: UTRDIAG 

Site Flr RPos Bay_id Shf Description Slot EqPEC 

HOST 01 NO2 LTE 00 18 DTC: 000 17 6X92 

Prior REX failure was TUE. 1992/06/27 at 10:02:47. 
First pass after prior failure was WED. 1992/06/28 at 
02:15:24 


Explanation: A diagnostic has failed during inactive out-of-service tests. The 
REX failure string has changed from REX test failed-Inactive OOS 
tests to REX test failed-OOS tests of InActive Unit 1. 
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DTC level commands D-935 
tst (continued) 


Examples of the tst command (continued) 


Example Task, response, and explanation 
tst rex query — 


Task: Display a record of REX maintenance. 


Response: 
SMS 0 is included in the REX schedule. 
Last REX date was THU. 1992/06/29 at 09:53:57; FAILED. 
REX test Failed - OOS test of InActive Unit 1 before SwAct 


Diagnostic Failures: MSGDIAG, SPCH DG, TS DIAG, TONESDG 
FORMATR, CSMDIAG, UTRDIAG, PADRING 
SMS AB , MSG IMC, SYNC DG 
Site flr RPos Bay_id Shf Description Slot EqPEC 
HOST 01 L15 LTE 00 1 SMR : 000 20 6X42 
HOST 01 L15 LTE 00 18 SMR : 000 21 6X41 
HOST 01 L15 LTE 00 18 SMR : 000 18 6X69 
HOST 01 L15 LTE 00 18 SMR : 000 14 6X44 
HOST 01 L15 LTE 00 18 SMR : 000 19 6X80 


Prior REX failure was TRU. 1992/06/27 at 10:02:47. 
First pass after prior failure was WED. 1992/06/28 at 
02:15:24 


Explanation: The REX test fails because the multiple diagnostics fail during the 
RTS of the inactive unit before a SwAct. 
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D-936 DTC level commands 
tst (continued) 


Responses 


The following table describes the meaning and significance of responses to 
the tst command. 


Responses for the tst command 


MAP output Meaning and action 


6X45 PEC MISMATCH 
available_pecs 


Meaning: The tests cannot occur because the datafilled entry in the inventory table 
does not match the PEC of the NT6X45 card. 


Action: Check the PECs of the NT6X45 cards in use and ensure that the one 
with the lowest suffix is the one datafilled in Table DTCINV. 


A WARM SWACT WILL BE ATTEMPTED DURING THE REX SEQUENCE 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


YES 


REQUEST SUBMITTED 


Meaning: In response to the command string tst rex now nowait, the system 
requests a warm SwAct after a user response. After a YES response, a 


warning is given that REX will perform a warm SwAct. The user has 
chosen to proceed with the REX test. After the “Request Submitted” 
response, the user may proceed with other commands from the MAP 
terminal while the REX test is being performed. REX results are 
suppressed on the MAP screen. Peripheral states and maintenance 
progress indicators are displayed as usual. 


The system performs a REX test on the posted peripheral. Logs are 
output and the REX maintenance record is updated as usual. 


Action: REX progress can be followed by viewing maintenance progress 
indicators on the MAP display of the posted peripheral. Refer to logs 


and/or REX maintenance record (command string tst rex query after 
posting the desired peripheral) for results of the REX test. 


CMR Tst Passes 
Meaning: The NT6X78 CMR card test passed. 


Action: None 
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tst (continued) 


Responses for the tst command (continued) 
MAP output Meaning and action 


CS LINK UNAVAILABLE 
NO ACTION TAKEN 


Meaning: The C-side links used for messages are both out-of-service; therefore, 
the PM cannot communicate with the CC. 


Action: None 


INSVCE TESTS INITIATED 
DTC 0 TST PASSED 


Meaning: In-service testing is being performed on the posted PM which is in the 
InSv or ISTb state. PASSED appears when testing is satisfactorily 
completed. 


Action: None 


LAST REX DATE WAS day mmdd AT hh.mm; results 
the response is displayed with: 

DTC 0 IS INCLUDED IN THE REX SCHEDULE 

DTC 0 IS REMOVED FROM THE REX SCHEDULE 


Meaning: With the command string tst rex query, the date of the last REX test is 
given where 

day is an abbreviation for the day of the week, for example, MON 
for Monday 

mmdd is an abbreviation for the month and includes the date of the 
day, for example, SEPO7 for September 7 

hh.mm denotes the time in hours and minutes that the REX test 
occurred 

results gives the results of the last REX test (PASSED or FAILED) 


Action: None 
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D-938 DTC level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


DTC 0 is 
Last REX 
REX test 
Site Flr 
HOST 01 

No prior 


included in the REX schedule. 

date was TUE. 1990/11/27 at 10:02:47; FAILED 
Failed - Inactive OOS tests after SWACT 

RPos Bay_id Shf Description Slot EqgPEC 

NO2 LTE 00 18 DTC : 00 17 6X62 

REX failure. 


Meaning: In response to the command string tst rex query, information is displayed 
showing that DTC 0 received last REX test on Tue., Nov 27 1990 at 
10:02 am, and the test failed during Out of Service tests on the Inactive 
unit after the SwAct. A list of one card which may be defective is given 
in standard card display format. The REX test had not failed prior to this 
most recent REX. 


Action: The user should perform further analysis on the card listed, the XPM unit 
indicated, or the XPM node to determine the exact cause of the REX 
failure and correct it. Consult the logs for further information. 
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DTC level commands D-939 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


DTC 0 is included in REX schedule. 
Last REX date was THU. 1992/06/20 at 09:53:57; FAILED. 
REX test Failed - SwAct to Unit <unit> refused by SwAct Controller 
Inactive Unit 1 has a history of: 
<history text> 
Inactive Unit 1 is reporting: 
<xpm_text> 
Prior REX failure was TUE. 1992/06/27/ at 10:02:47 
First pass after prior failure was WED> 1992/06/28 at 02:15:24 
Meaning: This the response for a preSwAct failure, where: 
<unit> is the DTC unit and has a range of 0-1 
<history text> is one of the following: 
- PreSwAct query failure 
- IMC link failures 
- Message link failures 
- Parity audit failures 
- Superframe sync failures 
- Failure to maintain activity 
<xpm_txt> is one of the following: 
- Unit is jammed inactive 
- Unit is in overload 
- Message link failure 
- Static data corruption 
IMC link failure 
<act> MSGDIAG failure 
<act> AB DIAG failure 
<act> CSMDIAG failure 
<act> TS DAIG failure 
<act> TONESDG failure 
<act> CONT DG failure 
<act> SPCH DG failure 
<act> SMS AB failure 
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D-940 DTC level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


<act> PADRING failure 
<act> SMS MSG failure 
<act> UTRDIAG failure 
<act> RDD FMT failure 
<act> 6X48AUD failure 
<act> PS LOOP failure 
<act> FORMATR failure 
<act> STRDIAG failure 

- <act> AMUDIAG failure 

- <act> MX76 MSG failure 

<act> is one of the following: 

- Active inservice 

- Active out of service 

- InActive inservice 

- Inactive out of service 

Action: None 


DTC 0, CHECKSUM=# hhh, AGREES. 
OK 


Meaning: The test passes. The checksum agreement referred to (AGREES) is 
between a recent value for the data in the PM and the load-time value as 
stored in the CC. This confirms that the PM load has not been 
completed. 


Action: None 
DTC 0 IS rex_status 


Meaning: The REX tests are deactivated or queried, where rex_status is either: 
INCLUDED IN THE REX SCHEDULER 
or 
REMOVED FROM THE REX SCHEDULER 


Action: None 
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tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


DTC 0 MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTC cannot be tested because it is already undergoing 
maintenance action. 


Action: SYSTEM: With parameter all, the DTC is bypassed from the posted set 
of XPMs only for the duration of the testing. 


DTC 0 REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With parameter all, an DTC in the posted set cannot be tested because 
it is not in the manually busy state. The DTC in the posted set is 
bypassed by the testing. 


Action: To proceed with the maintenance, wait until the action on the posted set 
is completed, then make the DTC busy with the bsy command before 
trying the tst command. 


NON-DESTRUCTIVE ROM TEST AND 
OSVCE TESTS WILL BE RUN 


Meaning: The non-destructive tests occur for both the in-service and out-of-service 
unit or XPM. The maintenance flag NONDESTR ROM TST appears 
while testing occurs. Log PM181 records when the XPM is at the ROM 
level of maintenance. 


Action: Wait for the tests to complete. If the tests fail, check the PECs of the 


NT6X45 cards in use and ensure that the one with the lowest suffix is 
the one datafilled in Table DTCINV. 


NON-DESTRUCTIVE ROM TEST WILL BE RUN 


Meaning: The non-destructive tests occur for the in-service unit or PM. The 
maintenance flag NONDESTR ROM TST appears while testing occurs. 


Action: Wait for the tests to complete. If the tests fail, check the PECs of the 
NT6X45 cards in use and ensure that the one with the lowest suffix is 
the one datafilled in Table DTCINV. 
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D-942 DTC level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


NO PM POSTED 


Meaning: The PM must be posted before using the tst command. Posting aPM 
identifies to the system the PM that is to have maintenance action. 


Action: None 


NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


Meaning: The testing cannot occur because the datafilled entry in the inventory 
table does not match the PEC of the NT6X45 card or because the 
system does not reply to the ROM/RAM query. The maintenance flag 
ROM/RAM QUERY appears while the load is being queried. Log PM181 
records when the XPM is at the ROM level of maintenance. 


Action: Check the PECs of the NT6X45 cards in use and ensure that the one 
with the lowest suffix is the one datafilled in Table DTCINV. 


OSVCE TESTS INITIATED 
DTC n UNIT n TST PASSED 


Meaning: One unit of the DTC has been tested, where n is the respective 
discrimination number. If both units are tested, the response occurs for 
each unit. 


Action: None 


REPLACE CARDS IN CARDLIST: 
card_list 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the loading, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


REQUEST INVALID 


Meaning: The in-service tests occur if the selected PM is in the InSv state, or 
out-of-service tests occur if the PM is in the ManB or SysB state. 


Action: None 
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tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Re-enter the command tst. 
REX REQUEST INVALID: MTCE IN PROGRESS 


Meaning: A REX test cannot be started on the PM because other maintenance 
actions are already in progress. 


Action: None 
REX TEST PASSED 
Meaning: The REX test is successful. 


Action: None 
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D-944 DTC level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


REX test failed - <fail_reason> 


Meaning: The REX test failed or is incomplete because of one of <fail reasons> 
listed below: 


InSv tests of inactive unit O before SwAct 

InSv tests of inactive unit 1 before SwAct 

OOS tests of inactive unit 0 

OOS tests of inactive unit 1 

RTS of inactive unit 0 

RTS of inactive unit 1 

InSv tests of active unit O after SwAct (card list also produced) 
InSv tests of active unit 1 after SwAct (card list also produced) 
InSv tests of inactive unit O after SwAct (card list also produced) 
InSv tests of inactive unit 1 after SwAct (card list also produced) 
RTS of inactive unit O after SwAct 

RTS of inactive unit 1 after SwAct 

Achieving superframe/data synbc of unit 0 

Achieving superframe/data synbc of unit 1 


Achieving superframe/data synbc of unit O after SwAct 


Achieving superframe/data synbc of unit 1 after SwAct 


REX test failed-warm SwAct 

REX test failed-terminated due to warm SwAct turned off 

REX test failed-terminated due to preSwAct Audit failure 

REX test failed-terminated due to an autonomous SwAct 
Action: None 
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DTC level commands D-945 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


SUMMARY: 
nnn PASSED 
nnn NOT SUBMITTED 


Meaning: With the all parameter, summary is given of the quantity (nnn) of XPMs 
in the posted set that have been successfully tested or that have been 
bypassed by the testing. 


None 


SMS 0 is included in the REX schedule. 
Last REX date was THU. 1992/06/29 at 09:53:57; FAILED. 
REX test Failed - OOS test of InActive Unit 1 before SwAct 


Diagnostic Failures: MSGDIAG, SPCH DG, TS DIAG, TONESDG 
FORMATR, CSMDIAG, UTRDIAG, PADRING 
SMS AB , MSG IMC, SYNC DG 
Site flr RPos Bay_id Shf Description Slot EqPEC 
HOST 01 115 LTE 00 18 MR : 000 20 6X42 
HOST 01 2115 LTE 00 1 MR : 000 21 6X41 


HOST 01 115 LTE 00 
HOST 01 115 LTE 00 


000 14 6X44 
000 19 6x80 


S 
1 SMR : 
HOST 01 115 LTE 00 ale SMR : 000 18 6X69 
1 SMR 
SMR 


M 


Prior REX failure was TRU. 1992/06/27 at 10:02:47. 
First pass after prior failure was WED. 1992/06/28 at 02:15:24 


Meaning: The REX test fails because the multiple diagnostics fail during the RTS 
of the inactive unit before a SwAct. 


Action: None 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EQPEC 
card_list 


Meaning: Results of tests are displayed using the standard. 


Action: None 
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D-946 DTC level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


TEST RESOURCES IN USE 
NO ACTION TAKEN 


Meaning: Test facilities are already temporarily in use for other maintenance 
actions. 


Action: None 


THE ROM TEST IS DESTRUCTIVE 
THE RAM LOAD WILL BE LOST FOR UNIT u 
(PLEASE CONFIRM “YES”, “Y”, “NO”, OR “N”): 


Meaning: The RAM load is erased in the unit(s) because of the ROM test, where u 
isO or. 


Action: To replace the RAM load, reload the units using the loadpm command. 


THIS OPERATION WILL BE EXECUTED ON nnn DTC 
(PLEASE CONFIRM “YES”, “Y”, “NO”, OR “N”): 


Meaning: A quantity of nnn DTCs in the posted set is to be tested. 


Action: Entering YES tests the DTC(s). 
Entering NO aborts the action. 


With YES, the status display of the DTC in the current position of the 
posted set shows the maintenance flag Mtce while testing is in progress. 


TRY PMRESET 


Meaning: For XPMs with an NT6X69 messaging card, testing cannot occur 
because the static data must be reloaded. 


Action: Use the pmreset command 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: Testing by the mate test is cancelled if the status or the activity of the 
active unit changes. 


Action: Wait for the changes to complete. 
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DTC levelcommands D-947 
tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: As part of the maintenance actions for testing a unit by its active mate, 


testing from the mate unit cannot occur when maintenance is already in 
progress on the mate unit. 


Action: Wait for the maintenance action(s) to complete. 
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DTC level commands D-949 
warmswact 


Function 
Use the warmswact command to turn on or off or query the state of the 
automatic switch of activity feature of the units of the posted DTC. 


warmswact command parameters and variables 
Command Parameters and variables 


warmswact on posted prompt 
off all noprompt 


query 


Parameters 
and variables Description 


This parameter includes all XPM units of the posted set. 


This parameter is used to avoid confirmation requests for each unit affected when 
command string warmswact on all is entered. 


This parameter cancels the automatic switching of the activity states of the XPM 
units. 


This parameter allows the automatic switching of the activity states ofthe XPM 
units. 


posted This default parameter, which is never entered, indicates that only the DTC 
currently posted will be affected by the command because the all parameter is not 
entered. 


This default parameter, which is never entered, indicates that confirmation requests 
prompts will be displayed for each unit affected requiring yes or no response 
because the noprompt parameter is not entered. 


This parameter gives the status of warm SwAct as on or off. 


Qualifications 
The warmswact command is qualified by the following: 
e When the command string warmswact on is executed, calls in process 
are maintained when the activity states of the units are switched. 
e When the command string warmswact off is executed, calls in process 
are dropped when the activity states of the units are switched. 


e If an attempt to change the warm SwAct capability is made while a 
SwAct is in progress, a message will be displayed stating that the attempt 
is disallowed and no action will be taken. 
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D-950 DTC level commands 
warmswact (continued) 


Example 
The following table provides an example of the warmswact command. 


Example of the warmswact command 


Example Task, response, and explanation 


warmswact on — 


Task: Enable warmswact for the posted DTC. 


Response: 
Warm SwAct turned ON for DTC 22 by WARMSWACT command 


Explanation:Warm SwAct is enabled for DTC 22. 
warmswact on all noprompt .| 
Task: Enable warm SwAct for all DTCs in the posted set. 
Response: 
**WARNING** Inactive units of PMs in the current posted 
set may temporarilyt be removed from service 
This operation will be executed on <n> DTC 


Please confirm (“YES”, “Y”, “NO”, OR “N”): 


Explanation:This warning results form the use of the noprompt parameter. 


Response 


The following table provides an explanation of the response to the 
warmswact command. 


Response for the warmswact command 


MAP output Meaning and action 


Warm SwAct turned ON for DTC 22 by WARMSWACT command 


Meaning: This is response to a successful warmswact on command. 


Action: None 
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DTC level commands D-951 
warmswact (end) 


Response for the warmswact command (continued) 

MAP output Meaning and action 

Warm SwAct turned OFF for DTC 0 by WARMSWACT command 
Meaning: This is the response to a warmswact off command. 


Action: None 


**WARNING** Inactive units of PMs in the current posted 
set may temporarilyt be removed from service 

This operation will be executed on <n> DTC 

Please confirm (“YES”, “Y”, “NO”, OR “N”): 


Meaning: This is the warning and rewponse to a warmswact on all noprompt 
command. 


Action: Type yes or y to continue executing the command; type no or n to abort 
the command. 


This operation will be executed on <n> DTC 
Please confirm (“YES”, “Y”, “NO”, OR “N”): 


Meaning: This is the response to a warmswact on all command. 


Action: Type yes or y to continue executing the command; type no or n to abort 
the command. 
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DTC level commands D-953 
xpmlogs 


Function 


Use the xpmlogs command to enable logs to be generated from the XPM 
and to report internal XPM software errors (SWERRS). 


xpmlogs command parameters and variables 


Command Parameters and variables 


xpmlogs 


Parameters 
and variables Description 


This parameter enables logs to be printed. 
This parameter prevents logs from being printed. 


This parameter gives the status of XPM_LOGS as on or off. 


Qualification 


The xpmlogs command is cancelled by a reload or restart by a default 
setting. 


Example 
The following table provides an example of the xpmlogs command. 


Example of the xpmlogs command 


Example Task, response, and explanation 


xpmlogs on. 


Task: Enable log reporting for the posted DTC 


Response: DTC 0 unit 0 xpmlogs mtc Passed 
DTC 0 unit 1 xpmlogs mtc Passed 


Explanation:Log reports for the posted DTC will be generated. 
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D-954 DTC level commands 
xpmlogs (end) 


Responses 


The following table provides explanations of the responses to the xpmlogs 
command. 


Responses for the xpmlogs command 


MAP output Meaning and action 


DTC 0 unit 0 xpmlogs mtc Passed 
DTC 0 unit 1 xpmlogs mtc Passed 


Meaning: The response occurs in pairs, one for each DTC unit for either the 
xpmlogs on or xpmlogs off command. 


Action: None 


Logs from xpm are disabled 
or 
Logs from xpm are enabled 


Meaning: The status of xpmlogs is given in the display in response to the xpmlogs 
query command. 


Action: None 
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DTC level commands D-955 
xpmreload (end) 


Function 


Use the xpmreload command to reload selected segments in the XPM or in a 
unit of the XPM. 


xpmreload command parameters and variables 
Command Parameters and variables 


xpmreload De unit unit_no ] file_name 
pm 


Parameters 
and variables Description 


file_name This variable is the name of the segment reload file. 


pm This parameter indicates that both units of the posted DTC are to be reloaded. 


pm_type This parameter identifies the PM type targeted for segment reloading, which in this 
case is the DTC. The pm_type will be DTC. 


unit This parameter indicates that a unit is to be specified. 


unit_no This variable specifies the unit of the DTC to be loaded and has a range of 0-1. 


Qualifications 
None 


Examples 
Not currently available 


Responses 


Not currently available 
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DTC level commands D-957 
xpm reset 


Function 


Use the xpmreset command to reinitialize a posted DTC or one of its units 
after being reloaded. This reset verifies that the reload is correct. 


xpmreset command parameters and variables 
Command Parameters and variables 
xpmreset tstdat 


unit_no nodata 
norun 


Parameters 
and variables Description 


pm This parameter reinitializes both units of the posted DTC. 

norun This parameter resets the PM without initializing or sending static data and execs. 

unit This parameter reinitializes one unit of the posted PM. 

unit_no This parameter specifies which unit of the posted PM is to be reset. The range is 
0-1. 

nodata This parameter resets the units after initialization without sending data and execs. 

tstdat This default parameter, which is never entered, resets the units after initialization 
and sending data and execs, because neither the nodata or norun parameters are 
entered. 

Qualifications 
None 
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D-958 DTC level commands 
xpmreset (continued) 


Example 
The following table provides an example of the xpmreset command. 


Example of the xpmreset command 


Example Task, response, and explanation 


xpmreset unit 0 
where 


0 is the number of the unit to be reset. 
Task: Reset unit 0 ofthe posted DTC. 
Response: UNIT 0 IN ESA MODE 


THIS ACTION WILL CAUSE ESA EXIT AND ABORT 3 CALLS 
PLEASE CONFIRM (“YES”, “Y”, “NO”, OR “N”) 


Explanation:The resetting of an DTC equipped with ESA cancels calls. 
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DTC level commands D-959 
xpmreset (continued) 


Responses 


The following table provides explanations of the responses to the xpmreset 
command. 


Responses for the xpmreset command 


MAP output Meaning and action 


FAILED TO SEND RESET MESSAGE 
<card_list> 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not reset. The card is one or more of the listed cards, 
where <card_list> is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 


NT6X72 
Action: None 
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D-960 DTC level commands 
xpmreset (continued) 


Responses for the xpmreset command (continued) 
MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
<card_list> 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X40 
NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 


NT6X69 
Action: None 


NO RESPONSE FROM PM 


Meaning: If the response occurs for norun before the reset status, there is a 
hardware fault for transmitting or a fault in the ROM. If the response 
occurs for nodata during initialization, the load is not acceptable after the 
following display messages: 


/Reset 
/Status 
/Run 


/Initializing 


Action: Use the command loadpm to reload the PM. 
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DTC level commands D-961 
xpmreset (continued) 


Responses for the xpmreset command (continued) 
MAP output Meaning and action 


NO RESPONSE FROM PM AFTER ROMTEST 
<card_list> 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 


NT6X47 
Action: None 


NO RESPONSE FROM PM AFTER STATUS 
<card_list> 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 


NT6X69 
Action: None 
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D-962 DTC level commands 
xpmreset (end) 


Responses for the xpmreset command (continued) 


MAP output Meaning and action 


NO WAI RECEIVED AFTER RESET 
<card_list> 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not present. The card is one or more of the cards 
listed below 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X46 (FP memory) 
NT6X47 

NT6X50 

NT6X69 


NT6X72 
Action: None 
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D-963 


DTCI level commands 


Use the DTCI level of the MAP to maintain an digital trunk controller ISDN 
(DTCD. 


Accessing the DTCI level 
To access the DTCI level, enter the following from the CI level: 
mapci;mtc;pm;post dtci n | 
where 
n is the discrimination number of the DTCI to be posted. 


DTCI commands 


The commands available at the DTCI MAP level are described in this 
chapter and arranged in alphabetical order. The page number for each 
command is listed in the following table. 


DTCI commands 


Command 


abtk 

bsy 

disp 
listset 
loadpm 
next 

offl 
patchxpm 


perform 


pmreset 


post 
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D-964 DTCI level commands 


DTCI commands (continued) 


Command 


querypm 
quit 
rts 


tst 
warmswact 


xpmlogs 


DTCI menu 


The following figure shows the DTCI menu and status display. The insert 
with hidden commands is not a visible part of the menu display. 


CM MS IoD Net PM ccs LNS Trks Ext APPL 

DTCI 

0 Quit SysB ManB OffL CBsy ISTb InSv 
2 Post_ PM 4 0 10 3 3 130 
3 Listset DTEL 0 0 0 0 1 40 
4 

So: TÉnsl:- 

6 Tst_ DTCI 0 ISTb Links_OOS: Cside 0 ; Pside 0 
7 Bsy_ Unit 0: Act ISTb 

8 RIS_ Unit 1: InAct ManB Mtce 

9 OffL_ 

10 LoadPM_ 

1 Disp_ Hidden commands 

2 Next_ 

13 SwAct_ abtk 

14 QueryPM_ patchxpm 

15 pmreset 

16 warmswact 

7 Perform xpmlogs 

8 
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DTCI level commands D-965 


DTCI status codes 
The following table describes the status codes for the DTCI status display. 


Status codes DTCI menu status display 
Code Meaning Description 
DTCI nn 


0-127 DTCI This is the discrimination number of the posted DTCI. 
number 


LCME n 


0 or 1 LCME This identifies the upper or lower unit of the LCME frame. 
frame 


Cside x 
x This identifies the number of C-side links that are out-of-service. 

Pside x 
This identifies the number of P-side links that are out-of-service. 


Central PMs connected to the network are unable to communicate with the CC 
Side Busy because the network or the links used to carry messages between the 
PM and the P-side of the network are unavailable. 


A PM that is connected to the network by one or more PMs are 
out-of-service because its C-side of the PM or the links of a PM are 
unavailable. 


In Service PMs are in service and available to support any intended process, for 
example, call processing. 


In-Service PMs are still in service but flagged by system maintenance because 
Trouble either: 


a minor error condition occurred 

P-side link trouble 

static data that is not up to date 

a load that is not listed in Table LCMINV 


Manual PMs are manually removed from service by command bsy to allow 
Busy testing and other manual maintenance action. 


Not PMs are not equipped in Table LCMINV or LTCINV. 
Equipped 


Offline PMs are out-of-service for office data modifications (ODM). 


System PMs are automatically removed from service by system maintenance. 
Busy 
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DTCI level commands D-967 
abtk 


Function 


Use the abtk command to abort all active maintenance actions on a posted 
digital trunk controller, ISDN (DTCI). The state of the DTCI remains the 
same. 


abtk command parameters and variables 


Command Parameters and variables 


There are no parameters or variables for this command. 


Qualifications 


The abtk command is qualified by the following exceptions, restrictions and 
limitations: 


e Use the abtk command when using the loadpm command to cancel the 
entry of a wrong I_name parameter, or when the unit is executing 
maintenance processes. 


e The loadpm command without the nowait parameter locks the terminal 
keyboard so other commands cannot be entered until the process is 
completed. The abtk command unlocks the keyboard by cancelling the 
loading. 


Example 


The following table provides an example of the abtk command. 


Examples of the abtk command 


Example Task, response, and explanation 


Task: Abort all active maintenance actions on the posted DTCI. 


Response: <Display> 


Explanation: All active maintenance on posted DTCI is aborted. 
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D-968 DTCI level commands 
abtk (end) 


Responses 


The following table provides explanations of the responses to the abtk 
command. 


Responses for the abtk command 


MAP output Meaning and action 


display 


Meaning: This line is deleted from the loadpm display: 
LoadPM UNIT 1 /Loading 200 


Action: The abtk command deletes any part ofthe display associated with a 
previous active maintenance command such as: swact, tst, bsy, rts, offl, 
loadpm. It returns units to previous states. 


The displays for the following commands are unaffected: trnsl, disp, 
next, querypm. 


The post command is not cancelled and the previous DTCI posting is 
unaffected. 


ABORTING MAINTENANCE ON THIS PM WILL AFFECT 
MAINTENANCE ON OTHER PMS. 
PLEASE CONFIRM (“YES” OR “NO”) 


Meaning: Aborting a broadcast loading affects the loading of all PMs in the parallel 
loading of the posted set. 


Action: Enter YES to abort the loading. Groups of XPMs that have already been 
loaded remain loaded, while the group that has loading in progress 
retains the current load. Enter NO to allow the maintenance action to 
proceed. 
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DTCI level commands D-969 
bsy 


Function 


Use the bsy command to change the state of one or all posted digital trunk 
controllers, ISDN (DTCI) to manually busy (ManB). The bsy command can 
be applied to one or all units, the whole DTCI or all DTCIs, or one P-side 
link of one DTCI of the posted set. 


bsy command parameters and variables 


Command Parameters and variables 


ps_link wait | noforce 


nowait force all 
unit_no 


Parameters 
and variables Description 


This parameter simultaneously busies all of the specified unit or units or PMs of the 
same node type as the PM in the current position of the posted set. 


This parameter forces the posted PM, unit, or link to be made ManB even if 
maintenance actions are already in progress. For example, while a REX test is 
running. 


This parameter applies the bsy command to a specified P-side link between the 
posted DTCI and one of its associated line concentrating modules LCMs, LCMEs 
or LCMIs. 


This default parameter indicates the condition when no parameter is entered. The 
busy command will not be forced. 


This parameter allows other maintenance actions to occur before the bsy command 
is completed. 


This parameter busies all units of the posted DTCI. 
ps_link This variable specifies which P-side link is to be made ManB. The range is 0-19. 
unit This parameter busies one or all units of the posted DTCI. 


unit_no This variable specifies which unit of the posted DTCI is to be made ManB. The 
range is 0 or 1. 


wait This default parameter indicates the default condition when no parameter is en- 
tered. The user must wait until the bsy force command action is confirmed before 
additional commands can be entered at the MAP. 
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D-970 DTCI level commands 
bsy (continued) 


Qualifications 
The bsy command is qualified by the following exceptions, restrictions, and 
limitations: 
e The command bsy can cause a switch of activity (SwAct). When a link 


to an LCMI or LCME is busied, service on several D-channels on that 
PM is affected. 


e With parameter all, the larger the quantity of XPMs to be busied 
concurrently, the longer it takes to complete the busying. Other 
maintenance activities must wait until completion. 


Example 
The following table provides an example of the bsy command. 


Example of the bsy command 


Example Task, response, and explanation 


bsy unit 2. 
where 


2 is the unit number of the LCMI to be busied. 
Task: Busy unit 2 of the posted LCMI. 
Response: OK 


Explanation:Unit 2 of the posted LCMI is ManB. 


Responses 


The following table describes the meaning and significance of responses to 
the bsy command. 


Responses for the bsy command 


MAP output Meaning and action 


ALL OPTION NOT SUPPORTED FOR LINK PARAMETER 


Meaning: The parameter all does not apply to links because they must be busied 
one at a time. 


Action: To busy a link, use the parameter link without the parameter all. 
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DTCI level commands D-971 
bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


DTCI <nnn> UNIT <u> BSY PASSED 


Meaning: The state of the specified DTCI or unit is confirmed to be ManB, where 
<nnn> and <u> are the discrimination numbers. 


Action: None 


DTCI <pm_number> IS MANUAL BUSY 
NO ACTION TAKEN 


Meaning: The bsy command is applied to a PM that is already in the ManB state. 


Action: None 


DTCI <pm_number> MTCE IN PROGRESS ON EITHER OR BOTH UNITS 
Meaning: The DTCI cannot be busied because it is already undergoing 
maintenance action, where <pm_number> is the posted PMs 
discrimination number. 


Note: If parameter all is used, the DTCI is bypassed from the posted set of DTCls only while the DTCI 
is being busied. 


Action: None 


MTCE IN PROGRESS 


Meaning: The PM or unit cannot be busied while maintenance actions are already 
in progress. 


Action: To override and cancel the actions, use the parameter force. 
NO ACTION TAKEN 


Meaning: Indicates that “no,” is entered in response to a prompt and the command 
is aborted. 


Action: None 
NO PM POSTED 


Meaning: The PM must be posted before using the bsy command. Posting a PM 
identifies to the system the PM that is to have maintenance action. 


Action: None 
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D-972 DTCI level commands 
bsy (continued) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


Meaning: “Yes,” is entered in response to a prompt and the PM is busied. 


Action: None 


SUMMARY: 
<nnn> PASSED 
<nnn> NO SUBMITTED 


Meaning: If parameter all is used, a summary is given of the quantity (<nnn>) of 
DTCls in the posted set which have either been successfully busied, or 
which have been bypassed. 


Action: None 


THIS ACTION MAY CAUSE SWACT 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: When trying to busy an active unit, calls may be lost. If the inactive unit 
busied calls are not affected. 


Action: Use the swact command to switch the activity states of the two units so 
that the unit to be busied is inactive. 


THIS ACTION WILL TAKE AN LCMI OUT-OF-SERVICE 
PLEASE CONFIRM (“YES” OR “NO”) 


Meaning: This warning follows the entry of the command string bsy link (with or 
without the force command) if the specified link is a message link to the 
LCMI or LCME. 


Log PM182 (for information only) is generated whenever the command 
string bsy link is initiated to make a P-side link ManB. 


Action: None 
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DTCI level commands D-973 
bsy (end) 


Responses for the bsy command (continued) 


MAP output Meaning and action 


THIS ACTION WILL TAKE THIS PM AND ALL OF ITS SUBTENDING 
NODES OUT-OF-SERVICE 
PLEASE CONFIRM (“YES” OR “NO”) 


Meaning: This warning follows the entry of one of the following command strings, if 
the command is applied to the active unit while the other unit is 
out-of-service: 


bsy pm 
bsy unit unit_no 
bsy unit unit_no force 


The active unit is made ManB while the inactive unit is made SysB or 
CBsy. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON <nnn> DTCIS 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: A quantity of <nnn> DTCls in the posted set is to be busied. 


Action: If the user enters yes, the XPMs are busied. When the user responds 
with yes, the status display of the DTCI in the current position of the 
posted set changes to ManB and the status display for the PM level 
increments under the header ManB. 


If the user enters no, the action is aborted. 
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DTCI level commands D-975 
disp 


Function 


Use the disp command to display a list of all DTCIs in a specified peripheral 
module (PM) state. 


disp command parameters and variables 


Command Parameters and variables 


pm_state dtei 


Parameters 
and variables Description 


This variable is one of the codes listed in the Status codes DTCI menu status displ 
table at the beginning of this chapter. 


This parameter is the PM node-type parameter. 


This parameter is required before the PM state code 


Qualification 
None 


Examples 
Not currently available 
Response 


The following table describes the meaning and significance of responses to 
the disp command. 


Response for the disp command 
MAP output Meaning and action 
<pm_state> DTCI: NONE 


or 
<pm_state> DTCI <n>, <n> 


Meaning: There are no PMs in the specified state, or all in the specified state are 
listed, where <pm_state> is one of the codes listed in the DTCI status 
codes table at the beginning of this chapter. 


Action: None 
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DTCI level commands D-977 
listset 


Function 


Use the listset command to list the discrimination numbers of the PM types 
which are included in the posted set. 


listset command parameters and variables 


Command Parameters and variables 


listset all 
pm_type 


Parameters 
and variables Description 


This parameter lists all of the PM types which are in the posted set and includes their 
discrimination numbers. 


This variable specifies the type of PM in the posted set which is to be listed with a 
of its discrimination numbers. 


Qualifications 


The listset command is qualified by the following exceptions, restrictions, 
and limitations: 


e Entering the listset command without a parameter lists the PMs of the 
same type as the PM in the current position of the posted set. 


e Use the listset command to plan maintenance actions on sets of DTCIs of 
the same type. 


e Entering the command string help listset (to display the syntax of the 
command at the MAP) shows all of the PM types that use the listset 
command. However, the ability to use the command depends on the 
PMs included in the office configuration. 


Menu Commands Reference Manual-DATA Through DTC! 
Volume 3 of 10 BCS36 and up 


D-978 DTCI level commands 
listset (continued) 


Example 
The following table provides an example of the listset command. 


Examples of the listset command 


Example Task, response, and explanation 
listset all ı 


Task: List all posted PMs. 


Response: <pm_type> <pm_number>, <pm_number> 


<pm_type> <pm_number>, <pm_number> 


Explanation: From the posted set are listed the discrimination numbers of all 
PMs of the types listed in the PM status codes table in the PM MAP 
level chapter. 


Responses 


The following table describes the meaning and significance of responses to 
the listset command. 


Responses for the listset command 
MAP output Meaning and action 


<pm_type> <pm_number>, <pm_number> 


<pm_type> <pm_number>, <pm_number> 
Meaning: From the posted set are listed the discrimination numbers of all PMs of 
the types listed in the PM status codes table in the PM MAP level 
chapter. The list varies according to office configuration. 


Action: None 


NO PMS FOUND 


Meaning: The posted set of DTCls is empty. 


Action: None 
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DTCI level commands D-979 
listset (end) 


Responses for the listset command (continued) 


MAP output Meaning and action 


NO PMS OF SPECIFIED PM TYPE FOUND 


Meaning: The posted set does not contain DTCls of the specified type. 


Action: None 
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Function 


DTCI levelcommands D-981 
loadpm 


Use the loadpm command to load the peripheral program files into the 
processors of one or all posted DTCs. The PMs must be ManB or SysB 


before entering the loadpm command. 


loadpm command parameters and variables 


Command 


loadpm 
(continued) 


Parameters 
and variables 


Parameters and variables 


inactive ] noforce 


force 


wait 
nowait 


Description 


This parameter simultaneously loads all of the specified unit or DTCls of the same 
node type as the DTCI in the current position of the posted set. 


Note: With parameter all, the larger the quantity of DTCls to be loaded concurrently, the longer it 
takes to complete the loading. Other maintenance activities must wait until completion. 


This parameter specifies that the source of the load data is to be the DMS-100 
Central Control (CC) data store. Parameter cc is the default if no load source is 
entered. 


This parameter selects the load which consists of the static data and execs, but ndt 
the basic DTCI software. 


This parameter selects the load mode to be execs only. Execs are sets of 
instructions invoked by the DTCI in response to a CC request or DMS action. Exeps 
behave like mini-programs to handle call processing. 


This parameter bypasses the running of the ROM tests while loading occurs. 


This parameter selects the load mode which consists of the basic DTC software, 


plus the execs and the static data in the CC. The parameter full is the default if nq 
load mode is entered. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-982 DTCI level commands 
loadpm (continued) 


loadpm command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter loads the units which are in the inactive state. Ifthe parameter all 
is specified, DTCls with firmware card NT6X45BA or later are loaded by the mate 


unit. 


If the status display for the the units activity is blank, the CC prevents the loading. 
The action must be done by using explicit parameters. 


When parameter all is used uring an upgrade of XPM software, the inactive units 
that are to be loaded from their mate units display Broadcast Mate as their 
maintenance flag. 


This variable is the name of the CC data file for the posted DTCls. Load names ale 
listed in data Table LTCINV, field LOAD. 


This default parameter indicates the condition when no parameter is entered. 
Loadpm will not be forced. 


This parameter allows another DTCI to be posted and loaded without waiting for 
confirmation from the previous load request. 


This parameter loads both units of one or all posted DTCls. 


This variable is the name of the load that is to replace the load file name (I_name) 
for those PMs that cannot be loaded by the I_name load. 


This parameter loads one unit of one or all posted DTCls. 


This variable specified which unit of the posted DTCI is to be loaded. The range 
is 0 or 1. 


This default parameter indicates the default condition when no parameter is 
entered. The user must wait until the loadpm force command action is confirmed 
before additional commands can be entered at the MAP. 


Qualifications 


The loadpm command is qualified by the following exceptions, restrictions, 
and limitations: 


e Static data and tables define the configuration of the DTCI and 
subtending PMs. 
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DTCI level commands D-983 
loadpm (continued) 


The filename of the load appears on the display for the command 
querypm, nextto FNAME. The device where the load resides is 
specified in data Table PMLOADS. If the load filename is not specified 
with parameter all, the DTCIs are loaded with the filename that is 
recorded in the respective DTCI inventory table. More than one load 
can be used to load more than one PM. When loading static data into the 
PM, the NT6X78 CMR card in the DTCI is also loaded, if it is datafilled 
in Table LTCINV. 


The parameter nowait allows additional commands to be entered at the 
MAP while loading proceeds. Error messages in response to the loadpm 
command are recorded in PM logs. 


Filenames for replacement loads for these PMs must be listed in data 
Table DTCINV. The device where the load resides is specified in Table 
PMLOADS. 


While loading occurs, the progress of the loading is echoed by the 
appearance of; 


- the maintenance flag Mtce 


- One at a time, a combination of 
- [Reset 
- /Status 
- /ROM Test 
- /Loading: nnnnK 
- Initializing 
- /Static Data 
- Loading: Execs 
- where nnnn changes according to the increment of kilobits 
- The rate of appearance of any of these flags depends on the 
- amount of traffic on the switch. 


When using the parameter pm, the load filename is taken from the data 
table, and displayed by the command querypm. 


To determine the loads for each PM, use the nonmenu command inform. 


When the DTCI is not loaded, the only programs that are present for 
testing are located in the ROM. If the ROM test fails the loadpm 
command cannot be used. Ifthe ROM tests pass, the unlisted menu 
command loadnotest bypasses the ROM tests. 


To reload a PM, enter the loadpm command on the inactive unit. When 
loading is completed, enter the swact command. Then reenter the 
loadpm command for the newly inactive unit. 


When loading for the PM occurs, the NT6X78 CMR card in the DTCI is 
also loaded if the data Table DTCINV is datafilled. 
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D-984 DTCI level commands 
loadpm (continued) 


e When loading more than ten units, the action occurs in groups, submitted 
one after the other. If the broadcast loader or the mate broadcast loader 
is used, the duration is equivalent to loading one unit. Broadcast loading 
takes precedence over requests for single unit or single DTCI loading. 


e To locate a load’s filename, use the commands dskut and listvol at the 
DDU MAP level. Load”s file names are listed in data Table PMLOADS. 


e The failure reasons that prevent PMs in a posted set from being loaded 
by broadcast loading are described alphabetically as follows: 


- LOAD NOT RECEIVED FROM BROADCAST LOADER 
The PM through which the load was to be sent has not sent the load. 
It may be out-of-service. 


- NO RESPONSE FROM IPML SETUP MESSAGE 
The XPM has not responded to the IPML setup required for 
broadcast loading to occur. 


- NO RESPONSE FROM NIL EVENT TIMEOUT MESSAGE 
The XPM has not responded to the nil event timeout message. 


- NO RESPONSE FROM ROM/RAM QUERY MESSAGE 
The XPM has not responded to the ROM and RAM query message. 


Examples 
The following table provides examples of the loadpm command. 


Examples of the loadpm command 


Example Task, response, and explanation 


loadpm unit 1 J 
where 


1 is the unit number of the posted DTCI to be loaded 
Task: Load the peripheral program files into the processor of of DTCI unit 1. 
Response: LTC 0 ISTb Links_00S: CSide 0 PSide 0 

Unit 0: Act InSv 


Unit 1: InAct ManB Mtce /Loading: 0200 
LOADPM UNIT 1 


Explanation:Unit 1 of the poste DTCI is loaded. 
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DTCI level commands D-985 
loadpm (continued) 


Examples of the loadpm command (continued) 


Example Task, response, and explanation 


loadpm unit 0 cc data nowait — 
where 


0 specifies which unit of the posted DTCI is to be loaded 


Load unit O of the posted DTCI with data from the CC and allow the 
MAP to be used for other maintenance commands while loading 
occurs. 


Response: LTC 0 ISTb Links_00S: CSide 0 PSide 0 
Unit 0: InAct ManB Mtce /Loading: 0200 
Unit 1: Act InSv 

LOADPM UNIT 1 


Explanation:Unit 0 of the posted DTCI is loaded. 
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D-986 DTCI level commands 
loadpm (continued) 


Responses 


The following table describes the meaning of responses to the loadpm 
command. 


Responses for the loadpm command 


MAP output Meaning and action 


6X45 PEC MISMATCH 
<available_pecs> 


Meaning: The loading cannot occur because the datafilling entry in the inventory 
table does not match the PEC of the NT6X45 card. 


Action: The equipped PECs of NT6X45 cards are listed, where available_pecs 
is one or more card(s). Ifa question mark (?) is present instead of a 
PEC, the PEC can only be obtained by inspecting the appropriate card. 
Check the PECs of the NT6X45 cards in use and ensure that the one 
with the lowest suffix is the one datafilled in inventory Table LTCINV. 


FAILED TO SEND RESET MESSAGE 
<card_list> 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not reset. The card is one or more of the listed cards, 
where <card_list> is one of: 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 


NT6X72 
Action: None 
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DTCI level commands D-987 
loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
<card_list> 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of: 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 


NT6X69 
Action: None 


INACTIVE PARAMETER NOT VALID FOR OOS PM 


Meaning: The parameter inactive does not apply to out-of-service DTCls. The 
DTCI(s) must be in service. 


Action: The activity display for the XPM(s) is blank. To load the DTCI(s) that are 
bypassed from the posted set, busy the DTCls using the command bsy 
and use the command loadpm with the parameter unit or pm. 


LOAD FILE <file_name> NOT FOUND IN SYMBOL TABLE 


Meaning: The variables /_ name or r_name is not found in the system's symbol 
table. The symbol table is a pseudo-table for storing data for the 
duration of a MAP session. It is not a data table and is emptied by a 
reload or a restart. 


Check for a typographical error or check data Table DTCINV for the 
applicable r_name. If the location of the load file is not datafilled in data 
Table PMLOADS. 
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D-988 DTCI level commands 


loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 


LOAD FILE NOT IN DIRECTORY 


Meaning: The system cannot find the location of the load file. It resides on tape or 


disk. Use the command listvol to list the disk volume or the command 
mount to mount the tape that has the load file on it. 


Action: None 


DTCI <pm_number> UNIT <u> BROADCAST LOAD REQUEST SUBMITTED 


Meaning: The PMs in the posted set are being loaded by the broadcast method 


from the CC, where <pm_number> and unit <u> are the discrimination 
numbers of the specific PM(s). 


Action: None 


DTCI <pm_number> UNIT <u> BROADCAST MATE LOAD REQUEST SUBMITTED 


Meaning: The PMs in the posted set are being loaded by the broadcast method 


from the mate units, where <pm_number> and unit <u> are the 
discrimination numbers of the specific PM(s). 


Action: None 


<pm_type> <pm_number> IS <status> 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for loading, where <pm_type> is a PM 
listed in the PM status codes table in the PM MAP level chapter, 
<pm_number> is the discrimination number of the PM, and <status> is 
one of 


CBSY 
INSV 
OFFLINE 
The PM must be ManB. 


Action: None 
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DTCI level commands D-989 
loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 
DTCI <pm_number> LOADED 
Meaning: The PM has been successfully loaded. 


Action: None 


DTCI <pm_number> UNIT <u> LOAD FILE <file_name> IS NOT AVAILABLE 


Meaning: With the parameter all, the PM load <file_name> has already been 
identified as being unavailable. 


Action: The PM in the posted set is bypassed from the loading 


DTCI <pm_number> LOAD FILE IN INVENTORY TABLE NOT FOUND 
ENSURE THAT TABLE PMLOADS IS DATAFILLED CORRECTLY 


Meaning: The load's file name (parameter |_name) is not specified and the file 
name in the inventory data table does not correspond to a valid device in 
Table PMLOADS. 


Action: The PM in the posted set is bypassed from the loading. 


DTCI <pm_number> UNIT <u> LOADPM FAILED 
reason 
CAUSED FAILURE OF BROADCAST LOADER 


Meaning: As a member of the posted set intended for participation with broadcast 
loading, a PM’s failure to be loaded prevents the broadcast loading from 
occurring. Reasons for the failure are listed in Qualifications. 


Action: None of the PMs to be loaded by the broadcast method is loaded. PMs 
in the posted set using the single loading method are loaded. To allow 
the broadcast loading to proceed, remove the PM with the failure from 
the posted set and try again. 
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D-990 DTCI level commands 
loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


DTCI <pm_number> LOADPM FAILED 
LOAD NOT RECEIVED VIA BROADCAST LOADER 


Meaning: As a member of the posted set intended for participation with broadcast 
loading, this DTCI is not loaded because of a failure in another PM. 


Action: None of the PMs to be loaded by the broadcast method is loaded. PMs 
in the posted set using the single loading method are loaded. 
Investigate the cause of the failure to load the PM that is identified by the 
response CAUSED FAILURE OF BROADCAST LOADER. D proceed 
with the broadcast loading, remove the failed PM from the posted set 
and try the loadom command again. 


<pm_number> UNIT <u> LOAD REQUEST SUBMITTED 


Meaning: Only the PM in the current position of the posted set is being loaded 
from the CC. 


Action: None 


<pm_number> MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTCI cannot be loaded because it is already undergoing 
maintenance action, where <pm_number> is the discrimination number 
ofthe DTCI. 


Action: |f parameter all is used, the DTCI is bypassed from the posted set of 
DTCls only for the duration of the loading. 


<pm_number> NOT SUBMITTED AS INACTIVE UNIT NO LONGER MANB 
OR ACTIVE UNIT IS NOW OOS 


Meaning: As a member of the posted set that is to be loaded by the broadcast 
method, the PM is no longer ManB or the active unit is no longer in 
service. 


Action: The PM in the posted set is bypassed by the loading. 


<pm_number> NOT SUBMITTED AS STATE NO LONGER MANB 


Meaning: As a member of the posted set that is to be loaded by the broadcast 
method, the PM’s units are not both ManB. 


Action: The PM in the posted set is bypassed from the loading. 
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DTCI level commands D-991 
loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


DTCI <pm_number> UNIT <u> REPLACEMENT NAME MISMATCH 
WITH INVENTORY TABLE 


Meaning: The specified load filename does not match the filename that is 
datafilled in the inventory table for this PM. 


Action: The PM in the posted set is bypassed by the loading. 


<reason> 
NO ACTION TAKEN 


Meaning: The command cannot be executed for a reason other than those given 
in the standard responses. 


Action: None 


NO RESPONSE FROM PM AFTER ROMTEST 
<card_list> 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 


NT6X47 
Action: None 
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D-992 DTCI level commands 
loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 

NO RESPONSE FROM PM AFTER STATUS 
<card_list> 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 

NT6X69 


Action: None 


NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


Meaning: The loading cannot occur because the datafilled entry in the inventory 
does not match the PEC of the NT6X45 card or because the ROM/RAM 
query is not replied to. If parameter nowait is specified, this response 
does not appear. 


The maintenance flag ROM/RAM QUERY appears for the duration of the 
query. Check the PECs of the NT6X45 cards in use and ensure that the 
one with the lowest suffix is the one datafilled in Table LTCINV. 
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DTCI level commands D-993 
loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


NO WAI RECEIVED AFTER RESET 
<card_list> 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not present. The card is one or more of the listed 
cards, where <card_list> is one of 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X46 (FP memory) 
NT6X47 

NT6X50 

NT6X69 


NT6X72 
Action: None 


PM FAILED TO INITIALIZE 
TRY RELOADING THE PM 


Meaning: For DTCIs with an NT6X69 messaging card, loading cannot occur 
because a card is not initialized. 


Action: Reload the DTCI by entering the command pmreset or loadpm at a MAP. 


DTCI <pm_number> REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: If parameter all is used, an DTCI in the posted set cannot be loaded 
because it is not in the manually busy state. 


Action: The PM in the posted set is bypassed from the loading. To proceed with 
the maintenance, wait until the action on the posted set is completed, 
then busy the DTCI with the command bsy before trying the command 
loadpm. 
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D-994 DTCI level commands 
loadpm (continued) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 


REPLACE CARDS IN CARDLIST 
<card_list> 


Meaning: The results of the tests by the mate unit indicate that the cards are 
preventing the loading, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Enter the command loadpm again. 


SUMMARY : 
<nnn> PASSED 
<nnn> NOT SUBMITTED 


Meaning: If parameter all is used, a summary is given of the quantity (<nnn>) of 
DTCls in the posted set that have been successfully loaded or that have 
been bypassed by the loading. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON <nnn> DTCI 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: A number of nnn DTCls in the posted set is to be loaded. 

Action: Entering Yes loads the DTCI(s). With YES, the status display of the 
DTCI in the current position of the posted set shows the maintenance 
flag Mtce and shows the progression of the loading. 


Entering No aborts the action. 


TOO MANY CHARACTERS IN REPLACEMENT NAME 


Meaning: The variable r_name must be a string of eight characters or less. 


Action: Check for a typographical error or check data Table LTCINV for the 
applicable r_name. 
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DTCI level commands D-995 
loadpm (continued) 


Responses for the loadpm command (continued) 
MAP output Meaning and action 


TOO MANY DIFFERENT LOAD FILES REQUIRED. 
TRY A SMALLER SET OF PMS 


Meaning: With the command string loadpm pm all, if there are too many load 
filenames in the respective inventory data tables, the loading cannot 
occur. 


Action: Use the command post to create a posted set either with fewer PMs or 
with PMs or with PMs that require the same load’s file name, and enter 
the command again. 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: Mate loading is cancelled if the status or the activity of the active unit 
changes. 


Action: Wait for the changes to be completed. 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: Mate loading cannot occur when key software modules are missing from 
the load. 


Action: Wait for the resources to become available. 


UNABLE TO DIAGNOSE FROM MATE 
MATE MTCE IN PROGRESS - TRY AGAIN LATER 


Meaning: As part of the maintenance actions for testing a unit by its active mate, 
loading from the mate unit cannot occur when maintenance is already in 
progress. 

Action: Wait for the maintenance action(s) to be completed. 


WAITING FOR RESOURCES TO BECOME AVAILABLE 


Meaning: The system must wait to do maintenance because the maximum 
quantity of loading requests has been submitted. 


Action: Wait for the loading to complete or cancel the request with command 
abtk. 
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D-996 DTCI level commands 
loadpm (end) 


Responses for the loadpm command (continued) 


MAP output Meaning and action 
WARNING: LOAD FILE <file_name> HAS SAME NAME AS 
DATAFILLED IN INVENTORY TABLE BUT 

IS NOT ON THE SAME DEVICE AS 

INDICATED BY TABLE PMLOADS 


Meaning: Two load filenames are the same in a PM inventory data table and in 
Table PMLOADS. The specified file name matches the name in the 
inventory table, but not the name in Table PMLOADS. 


The PM in the posted set is bypassed by the loading. Check Table 
PMLOADS for the correct filename. 
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DTCI level commands D-997 
next 


Function 


Use the next command to place the next higher peripheral module (PM) of 
the set of posted DTCIs into the control position. 


next command parameters and variables 


Command Parameters and variables 


pmtype 


Parameters 
and variables Description 


This variable enables the system to select one of the PM types listed in the PM std- 
tus codes table in the PM MAP level chapter. Use the disp command to display the 
list of PM types in the posted set. The system selects the PMs in the sequence di$- 
played by this list. 


Qualifications 
None 


Example 
Not currently available 


Response 


The following table describes the meaning and significance of responses to 
the next command. 


Response for the next command 


MAP output Meaning and action 


END OF POST SET 


Meaning: The currently displayed PM is the last in the posted set of PMs, or if only 
one PM number has been posted. The display returns to the next higher 
menu level. 


Action: None 
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DTCI levelcommands D-999 
offl 


Function 


Use the offl command to set both units of one or all posted DTCIs to the 
offline state. The units must be in the ManB state before being set offline. 


offl command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter simultaneously makes offline all of the specified unit(s) or DTCls 
of the same node types as the DTCI in the current position of the posted set. 


Qualifications 
An offline DTCI remains in this state through all restarts. 


Example 
The following table provides an example of the offl command. 


Example of the offl command 


Example Task, response, and explanation 


Task: Put the posted DTCI in the offline state. 


Response: OK 


Explanation:The posted DTCI is made offline. 
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D-1000 DTCI level commands 
offl (continued) 


Responses 
The following table provides explanations of the responses to the offl 


command. 


Responses for the offl command 


MAP output Meaning and action 


Meaning: The posted DTCI is made offline. 


Action: None 


<pm_type> <pm_number> IS <status>. 
NO ACTION TAKEN 


Meaning: The PM is already offline or is in the incorrect state for being made 
offline, where <pm_type> is a PM listed in the PM status codes table in 
the PM MAP level chapter, <pm_number> is the discrimination number 
ofthe PM, and <status> is one of 


CBSY 
OFFLINE 


SYSTEM BUSY 
The PM must be ManB. 


Note: For some PM types, REQUEST INVALID appears before NO ACTION TAKEN. 


Action: None 


DTCI <pm_number> MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTCI cannot be made offline because it is already undergoing 
maintenance action, where <pm_number> is the discrimination number 
ofthe DTCI. 


If parameter all is used, the DTCI is bypassed from the posted set of 
DTCls only for the duration of being made offline 
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DTCI level commands D-1001 
offl (end) 


Responses for the offl command (continued) 


MAP output Meaning and action 


DTCI <pm_number> REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With parameter all, an DTCI in the posted set cannot be made offline 
because it is not in the manually busy state. 


Action: The DTCI is the posted set is bypassed from being made offline. To 
proceed with the maintenance, wait until the action on the posted set is 
completed, then make the DTCI busy with the command bsy before 
entering the command offl. 


SUMMARY 
<nnn> PASSED 
<nnn> NOT SUBMITTED 


Meaning: If parameter all is used, a summary is given of the quantity (<nnn>) of 
DTCs in the posted set that have been successfully made offline or that 
have been bypassed by the request. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON <nnn> DTCIS 
PLEASE CONFIRM (“YES” OR “NO”) 


Meaning: A quantity of <nnn> DTCls in the posted set is to be made offline. 


Action: Enter YES to make the DTCls offline. With YES, the status display of 
the DTCI in the current position of the posted set change to offl and the 
status display for the PM level increments under the header OFFL. 


Enter NO to abort the action. 
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DTCI level commands D-1003 
patchxpm 


Function 


Use the patchxpm command to change the load in the DTCI with new or 
altered software for a Single Change Supplement (SCS). The patchxpm 
command is recommended for use only by the maintenance support 
personnel. 


patchxpm command parameters and variables 
Command Parameters and variables 
patchxpm unit unit_no file_name patch 
pm check 
remove 
verify 
set 


clear 


Parameters 
and variables Description 


check This parameter verifies whether the old load is still in the XPM memory. 
clear The parameter cancels the set. 
file_name This variable is the name of the SCS file that is to be loaded. 
patch This parameter sends the data of the SCS file to the DTCI. 
This parameter changes both units of the posted PM. 
This parameter suspends the SCS load so that the old load resumes control. 


This parameter flags the SCS so that a reload of load files from dataBles LTCINV 
automatically includes the SCS file. 


unit This parameter changes one of the units of the posted DTCI. 


unit_no This variable specifies which unit of the posted DTCI is to be changed. The range 
is0 or 1. 


verify This parameter is the same as check for the changed load. 


Qualification 
The patchxpm command is replaced by other SCS nonmenu commands. 
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D-1004 DTCI level commands 
patchxpm (end) 


Example 
Not currently available 


Responses 
The following table provides explanations of the responses to the patchxpm 


command. 


Responses for the patchxpm command 


MAP output Meaning and action 


ACTION REQUIRES PATCH FILE 


Meaning: The action on the SCS file is one of patch, check, remove, verify, set, 
and clear. 


Action: None 


DTCI <n> UNIT <n> LOADPM FAILED 
<reason> 
or 

DTCI <n> UNIT <n> LOADPM PASSED 


Meaning: The actions of the command are confirmed, where <reason> is a 
variable text string to explain it. 


Action: None 
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DTCl level commands D-1005 
perform (end) 


Function 
The perform command is not functional for the DTCI level. 
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DTCI level commands D-1007 
pm reset 


Function 


Use the pmreset command to reinitialize a posted DTCI or one of its units 
after being reloaded. This reset verifies the reload is correct. 


pmreset command parameters and variables 


Command Parameters and variables 


pmreset norun 
unit_no nodata 


Parameters 
and variables Description 


This parameter resets the units after initialization, but without sending data and 
execs. 


This parameter resets the PM without initializing or sending static data and execs. 


pm This parameter reinitializes both units of the posted DTCI. 
unit This parameter reinitializes one unit of the posted PM. 
unit_no Un: Dee specifies which unit of the posted PM is to be reset. The range is 
or 1. 
Qualifications 
None 
Examples 


Not currently available 
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D-1008 DTCI level commands 
pmreset (continued) 


Responses 


The following table provides explanations of the responses to the pmreset 
command. 


Responses for the pmreset command 


MAP output Meaning and action 


FAILED TO SEND RESET MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not reset. The card is one or more of the listed cards, 
where card_list is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 
NT6X72 


Action: None 
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DTCI level commands D-1009 
pmreset (continued) 


Responses for the pmreset command (continued) 
MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card_list is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 


NT6X69 
Action: None 


NO RESPONSE FROM PM 


Meaning: If the response occurs for norun before the reset status, there is a 
hardware fault for transmitting or a fault in the ROM. If the response 
occurs for nodata during initialization, after these display messages: 


/Reset 
/Status 
/Run 


/Initializing 


the load is not acceptable. Use the command loadpm to reload the PM. 


Action: None 
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D-1010 DTCI level commands 
pmreset (continued) 


Responses for the pmreset command (continued) 
MAP output Meaning and action 


NO RESPONSE FROM PM AFTER ROMTEST 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card_list is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 


NT6X47 
Action: None 


NO RESPONSE FROM PM AFTER STATUS 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not communicating. The card is one or more of the 
listed cards, where card_list is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 


NT6X69 
Action: None 
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DTCI level commands D-1011 
pmreset (continued) 


Responses for the pmreset command (continued) 


MAP output Meaning and action 


NO WAI RECEIVED AFTER RESET 
card_list 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not present. The card is one or more of the listed 
cards, where card _list is one of 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X46 (FP memory) 
NT6X47 

NT6X50 

NT6X69 


NT6X72 
Action: None 


PM FAILED TO INITIALIZE 
TRY RELOADING THE PM 


Meaning: For XPMs with an NT6X69 messaging card, loading cannot occur 
because a card is not initialized. 


Action: Reload the XPM by entering the command pmreset or loadpm at a MAP. 


REPLACE CARDS IN CARDLIST 
<card_list> 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the resetting, where <card_list> is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 
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D-1012 DTCI level commands 
pmreset (end) 


Responses for the pmreset command (continued) 


MAP output Meaning and action 


RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not include a list of 
suspected cards. 


Action: None 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: Resetting by the mate test is cancelled if the status or the activity of the 
active unit changes. 


Action: Wait for the changes to complete. 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: Resetting for the mate tests cannot occur when key software modules 
are missing from the load. 


Action: Wait for the resources to become available. 


UNABLE TO DIAGNOSE FROM MATE 
MATE MTCE IN PROGRESS - TRY AGAIN LATER 


Meaning: As part of the maintenance actions for testing a unit by its active mate, 


resetting from the mate unit cannot occur when maintenance is already 
in progress on it. 


Action: Wait for the maintenance actions(s) to complete. 
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DTCI levelcommands D-1013 
post 


Function 
Use the post command access the PM sublevel for the specified PM, or sets 
of PMs, which are to undergo maintenance action by the corresponding 
menu of commands. 


post command parameters and variables 


Command Parameters and variables 


all 

allpms pm_state 

pm_state 

pm_type Ber | 
pm_state 


Parameters 
and variables Description 


all This parameter posts all PM numbers of the specified PM type. 


allpms This parameter posts all PM types for the specified PM numbers, or the specified 
PM states, or both. 


pm_number This variable is the discrimination number for the specified PM type. The format o 
the number varies, depending on PM type listed in the PM status codes table in the 
PM MAP level chapter. If there are two or more entries for pm_number, separate 
each entry by space. 


This variable is one of the codes listed in the Status codes DTCI menu status display 
table on page D-965. 


This variable identifies a PM type listed in the PM status display when the command 
status is entered. The default is the PM type of the MAP level. However, pm_typ¢ 
may default to the PM that is in the current position of the posted set. No all PM 
types have this default. (Other PM types that may be entered are identified in the 


PM types table located in the opening section of the PM MAP level.) 


Qualifications 
The post command is qualified by the following exceptions, restrictions, and 
limitations: 


e If the variable pm_type, or parameter allpms without any other 
parameters or variablesis used, use the post commands on the sublevel 
menus to select specific PM numbers. If you do no specify a PM 
number, the default command menu is displayed. Because the default 
menu does not include the dch and isg commands, DCH and ISG menu 
levels cannot be accessed. The default menu is also displayed if the PM 
specified by number is an DTCI not equipped with the optional ISP card. 


Menu Commands Reference Manual-DATA Through DTC! 
Volume 3 of 10 BCS36 and up 


D-1014 DTCI level commands 
post (continued) 


e To determine which PMs are configured in an office, use the command 
disp to display a list of the PM types and their range of discrimination 
numbers. 


e Because only the PM in the current position of the posted set is affected 
by the maintenance commands, unless you use the parameter all, use the 
command next to place the next PM in the set in the current position. 


e When the command string help post is entered to query the parameters of 
post, not all of the displayed parameters apply to an office or office 
network. The applicability of the parameters depends on the types of 
PMs present in the office configuration. For parameters that do not 
apply, one of several responses indicates it is ignored. 


Examples 
The following table provides an example of the post command. 


Examples of the post command 


Example Task, response, and explanation 


post insv istb — 
where 


insv, istb identifies pm_states of a set of all PMs to be posted 


Task: Post a set of various DTCls which are in the in-service and in-service 
trouble states. 


Response: (Not currently available) 


Explanation:Not currently available 


post Igci 2 4 Icmi all istb ~ 
where 


Igei identifies the pm_type to be posted. 

2,4 identifies the discrimination numbers for the pm_type to be posted. 
Icmi identifies additional pm_types to be posted. 

istb identifies the pm_state of the additonal pm_type to be posted. 


Task: Post all LGCls in the IsTb state. 
Response: (Not currently available) 


Explanation:Not currently available 
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DTCI level commands D-1015 
post (continued) 


Examples of the post command (continued) 


Example Task, response, and explanation 


post Igci 2 5 6 lcmi 24 4J 
where 


Igei identifies the pm_type to be posted. 
2,5,6 identifies the discrimination numbers for the pm_type to be posted. 


Icmi identifies additional pm_types to be posted. 
2,4 identifies the discrimination numbers for the additional pm_types to be posted. 


Task: Post sets of DTCIs and LCMIs. 
Response: (Not currently available) 


Explanation:Not currently available 


post Igci 3 4J 
where 


Igei identifies the pm_type to be posted. 
3 identifies the discrimination number of the pm_type to be posted. 


Task: Post DTCI 3. 
Response: 
SysB ManB Offl CBsy ISTb InSv 
PM 4 0 10 3 3 130 
DTCI 0 0 4 1 J; 40 
DTCI 3 


Explanation:DTCI 3 is posted. 
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D-1016 DTCI level commands 
post (end) 


Responses 


The following table provides explanations of the responses to the post 
command. 


Responses for the post command 
MAP output Meaning and action 
INVALID POST SET FAILED TO CREATE NEW POST SET 


Meaning: An incorrect pm_number, or the office is not configured for the specified 
pm_type. 


Action: None 


NO PM POSTED 


Meaning: With post pm_type, the respective PM level is accessed. To post a 
pm_type with the command post, include a pm_number. 


Action: None 
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DTCI level commands D-1017 
querypm 


Function 
Use the querypm command to display miscellaneous information about a 
posted DTCI. 


querypm command parameters and variables 


Command Parameters and variables 


querypm 


Parameters 
and variables Description 


This parameter displays the reasons for in-service trouble (ISTb) on the two units. 


This parameter diplays the contents of the DTCI maintenance counters which re- 
cord the number of times that each fault (flt) condition has occurred. It also displays 
the ROM and RAM load names. 


Qualifications 
The querypm command is qualified by the following exceptions, 
restrictions, and limitations. 


e Other fault conditions are: 
- Init-A CC restart has occurred and a return-to-service is attempted 
during restart. 
- Diagnostics Failed-The unit has failed TST or RTS. 
- Trap-The unit has sent an “intialization complete” message to the 
CC after an auto-restart. 
- Activity Dropped-A system-generated SwAct has occurred. 


- Audit-The internal software state of the active or inactive unit is 
incorrect. The active unit internal state should be RUNNING. The 
inactive unit internal state should be READY. Fault indications are: 
BUSY, RESTART, or SYNCING. 


- Unsolicited Message Limit Exceeded-The unit has sent more than 
100 unsolicited messages to CC within 1 minute. 


- CS Links-The CS message links have failed the periodic in-service 
C-side links test which occurs once per minute. 


e The following logs are generated when the indicated maintenance 
actions occur: 
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D-1018 DTCI level commands 
querypm (continued) 


- PM128-The NT6X78 CMR card is out-of-service. Until the card is 
returned to service or replaced, the XPM cannot be returned to 
service or tested by in-service tests. 


- PM180-The NT6X78 CMR card has a faults and a reset has been or 
1s being attempted. 


- PM181-The NT6X78 CMR card has failed a card test and therefore 
has caused the DTCI to have ISTb. 


Example 
Not currently available 
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DTCI level commands D-1019 
querypm (continued) 


Responses 


The following table describes the meaning of responses to the querypm 
command 


Responses for the querypm command 


MAP output Meaning and action 


QUERYPM 

PM TYPE: <type> PM NO.: <nnn> PM INT.#: <n> NODE_NO.: <nnnn> 
PMS EQUIPPED: <xxx> LOADNAME: <1_name> 

WARM SWACT IS SUPPORTED 

<status info> 

LAST REX DATE WAS <day> <mmdd> AT <hh.mm.> 

NODE STATUS: (OK, FALSE) 

UNIT 0 STATUS: {<status>, FALSE) 

UNIT 1 STATUS: {<status>, FALSE) 

SITE FLR RPOS BAY_ID SHF DESCRIPTION SLOT EQPEC 
<card_list> 


Meaning: A display similar to the above gives PM information where: 


<type> is a PM type listed in the PM status codes table in the PM MAP 
level chapter 
<nnn> is 0-127 for the discrimination number of the PM type. 
<n> is a software internal number 
<nnnn> is 0-2047 for the PM node number of PM number nnn. 
<l_name> is the name of the load file for the PM type. 
<status_info> is a reason for the status of a unit or node, where <status_info> 
can be: 
6X45 PEC MISMATCH BETWEEN INVENTORY TABLE & PM The 
mismatch means the datafilled entry in the inventory table does not match 
the PEC ofthe NT6X45 card. Check the PECs of the NT6X45 cards in 
use by entering querypm or by inspecting the card and ensure that the PEC 
with the lowest suffix is the one datafilled in Table LTCINV. 


NOT LOADED SINCE POWER UP The DTCI has not been loaded with 
software after having been powered up. The fault query of the NT6X45 
card indicates the need for a load. The system tries to auto-load the units 
before a return to service. If auto-loading fails, the DTC] must be manually 
busied and loaded (by the commands bsy and loadpm respectively). 

type nnn IN INCLUDED IN THE REX SCHEDULE. 


The PM is automatically scheduled for REX testing by the system. 
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D-1020 DTCI level commands 
querypm (continued) 


Responses for the querypm command (continued) 


MAP output Meaning and action 


<day> is an abbreviation for the day of the week; for example, MON for 
Monday. 

<mmdd> is an abbreviation for the month and includes the date of the day; 
for example, SEPO7 for September 7. 

<hh.mm> denotes the time in hours and minutes the the REX test occurred 

<status> is one of the PM status codes listed in the DTCI status codes table 
at the beginning of this chapter 

SITE begins the header string which identifies the location of a circuit 
according to the standard scheme. 

<card_list> is the list of potentially faulty cards. 


Action: None 


QUERYPM FLT 

NODE IS <status> 
<reason> 

UNIT 0 
<state> 

UNIT 1 
<state> 


Meaning: A display similar to the above gives PM fault information where: 


<status> is one of the PM status codes listed in the DTCI status codes table 
at the beginning of this chapter 
<reason> is one or more of the following: 


CLASS MODEM RESOURCE CARD 6X78AA OUT OF SERVICE 
means the CMR NT6X78 card in the DTCI is a cause of the DTCI 
having in-service trouble (ISTb) status. 


DATA NOT UP TO DATE indicates that data has not been 
updtaed. 


DISTRIBUTED DATA MISMATCH indicates that Data Mismatch 
means the data in the DTC and in the CC do not match; therefore, 
the DTC state is changed to in-service trouble (ISTb). 


NODE REDUNDANCY LOST (A UNIT IS OOS) means that one 
unit is out-of-service (OOS) and that SwAct cannot be done. For 
unit1, there has been a recent SwAct and the inactive unit is still 
SysB. The fault condition is caused by one unit being 
out-of-service. 
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DTCI levelcommands D-1021 
querypm (continued) 


Responses for the querypm command (continued) 


MAP output Meaning and action 


NON-CRITICAL HARDWARE FAULT means there is a fault with the 
NT6X69 card of the posted XPM. The XPM has been made ISTb 
because the IMC link between the units is faulty and the CC has 
closed the link. 


NOT LOADED SINCE POWER-UP means the DTCI has not been 
loaded with software after having been powered up. The query of 
the NT6X45 card indicates the need for a load. The system tries to 
auto-load the units before a return-to-service. If auto-loading fails, 
the XPM must be manually busied and loaded (by the commands 
bsy and loadpm respectively). 


PSIDE LINKS OUT-OF-SERVICE 
RESET 


<state> is one of 
NO FAULT EXISTS 
NOT status OR status 
status 
SYSTEM BUSY REASON: XPM SWACT ACTION 
REX failed 


Action: None 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-1022 DTCI level commands 
querypm (end) 


Responses for the querypm command (continued) 


MAP output Meaning and action 


QUERYPM CNTRS 
UNSOLICITED MSG LIMIT = <ttt>, UNIT 0 = <nnn>, UNIT 1 = <nnn> 
UNIT 0 
<count_info> 
UNIT 1 
<count_info> 
MP: <available_pec> SP: <available_pec> 


Meaning: A display similar to the above gives PM counter information where: 


<ttt> is the threshold limit for the number of unsolicited messages from 
the CC. Ifthe threshold is reached, the PM may cancel calls in 
progress. 


is the number of unsolicited messages which have accumulated for 
each unit. 


<count_info> is one of 
RAM LOAD: I_name1 
ROM LOAD: | name2 
or 
FAILED TO READ COUNTERS 
or 
nnn 


where | _ namel is the name of the load file for the unit, | name 2 is 
the firmware load file in the PM, and nnn is the count. The 
counters cannot be read because the respective unit is 
out-of-service. 


<available_pec> for an in-service unit, is a list of the 
available PECs of the equipped NT6X45 cards. MP 
indicates the master processor card while SP indicates the 
signaling processor card. If a question mark (?) is 
present instead of a PEC, the PEC can only be obtained 
by inspecting the appropriate card. 


Action: None 
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DTCI level commands D-1023 
quit 


Function 


Use the quit command to exit from the current menu level and return to a 
previous menu level. 


quit command parameters and variables 


Command Parameters and variables 


1 

all 
incrname 
n 


Parameters 
and variables Description 


This default parameter causes the system to display the next higher MAP level. 
This parameter causes the system to display the Cl level from any level. 


incrname This variable causes the system to exit the specified level and all sublevels. The 
system displays the next level higher than the one specified. Values for incrname 
are menu level names, such as Ins, mtc, or mapci. 


This variable identifies a specified number of retreat levels from the current level. 
The range of retreat levels is 0-6. However, the system cannot accept a level 
number higher than the number of the current level. 


Qualifications 
None 


Examples 
The following table provides examples of the quit command. 


Examples of the quit command 


Example Task, response, and explanation 


Task: Exit from the DTCI level to the previous menu level. 


Response: The display changes to the display of a higher level menu. 


Explanation: The DTCI level has changed to the previous menu level. 
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D-1024 DTCI level commands 
quit (continued) 


Examples of the quit command (continued) 


Example Task, response, and explanation 


quit mtc . 
where 


mtc specifies the level higher than the DTCI level to be exited 


Task: Return to the MAPCI level (one menu level higher than MTC). 
Response: The display changes to the MAPCI menu display: 
MAPCI: 


Explanation: The DTCI level has returned to the MAPCI level. 


Responses 


The following table provides an explanation of the responses to the quit 
command. 


Responses for the quit command 


MAP output Meaning and action 


Meaning: The system exited all MAP menu levels and returned to the Cl level. 


Action: None 


QUIT -- Unable to quit requested number of levels 
Last parameter evaluated was: 1 


Meaning: You entered an invalid level number. The number you entered exceeds 
the number of MAP levels from which to quit. 


Action: Reenter the command using an appropriate level number. 


The system replaces the DTCI level menu with a menu that is two or more levels higher. 


Meaning: You entered the quit command with an n variable value of 2 or more or 
an incrname variable value corresponding to two or more levels higher. 


Action: None 
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DTCI level commands D-1025 
quit (end) 


Responses for the quit command (continued) 


MAP output Meaning and action 


The system replaces the display of the DTCI level with the display of the next higher MAP level. 


Meaning: The system exited to the next higher MAP level. 


Action: None 
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DTCI levelcommands D-1027 
rts 


Function 
Use the rts command to return one or all the units of one or all the DTCIs in 
a posted set, or one P-side DS-1 link of the DTCI in the current position of 
the posted set to service. Tests are done and, if the tests succeed, a 
return-to-service (RTS) occurs. Each unit must be in the ManB or SysB 
state. 


rts command parameters and variables 

Command Parameters and variables 
active wait noforce all 
inactive nowait force 
link ps_link 


pm 
unit unit_no 


Parameters 
and variables Description 


This parameter returnsv one or all of the units in the active state to service. 


This parameter simultaneously returns all of the specified units or DTCls of the 
same node type as the DTCI in the current position of the posted set to service. 


This parameter bypasses pre-RTS test routines. The parameter force overrides all 
other commands that may be in effect on a unit unless maintenance actions are 
already in progress. 


This parameter returns-to-service one or all units in the inactive state. 


This parameter returns-to-service a specified P-side link between the posted DTC 
and one of its associated LCMIs or LCMEs. 


This default parameter indicates the condition when no parameter is entered. The 
rts command action will not be forced. 


This parameter allows other maintenance commands to be entered before bsy is 
completed. 


This parameter returns-to-service both units of one or all posted DTCls. 


This variable specifies which P-side link is to be returned-to-service. The range 
is O to 19. 


This parameter returns to service one unit of one or all posted DTCls. 
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D-1028 DTCI level commands 
rts (continued) 


rts command parameters and variables (continued) 


Parameters 
and variables Description 


unit_no This variable specifies which unit of the posted DTCls is to be returned-to-service. 
The range is 0 or 1. 


wait This default parameter indicates the default condition when no parameter is en- 
tered. The user must wait until the rts force command action is confirmed before 
additional commands can be entered at the MAP. 


Qualifications 
The rts command is qualified by the following exceptions, restrictions, and 
limitations: 


e When an DTCI is returned to service, all P-side links and DCHs attached 
to that DTCI are made SysB, and are returned to service. 


e When an DTCI is made SysB, the testing and loading associated with a 
a return to service are automatically initiated. 


e If the UNIT, PM, or LINK is CBsy, the command rts is executed without 
any testing and the status becomes CBsy. 


e When the active unit of the DTCI is returned to service, all P-side links 
are set to SysB, and then are returned to service, with a test performed on 
each link as it passes the test, unless the links are ManB. 


e If the NT6X78 CMR card fails the tests during an attempt to return the 
PM to service, the PM cannot be returned to service until the card is 
seated properly or replaced. 


+ Do not use the parameter force on the DTCI when the NT6X78 CMR 
card is present. If the card is in the process of initializing itself while the 
DTCI is being returned to service, the DTCI remains in the ManB or 
SysB state. reenter the rts command when the CMR card is initialized. 


e The following logs are generated when the indicated maintenance 
actions occur: 


- PM128-The NT6X78 CMR card is out of service. Until the card is 
returned to service or replaced, the DTCI cannot be returned to 
service. 


- PM180-The NT6X78 CMR card has a fault and a reset has been or 
is being attempted. The return to service has not occurred. 


- PM181-The NT6X78 CMR card has failed a card test and therefore 
cannot be returned to service. 


- PM184-A P-side link is returned to service. 
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DTCI level commands D-1029 
rts (continued) 


Examples 
The following table provides an example of the rts command. 


Example of the rts command 


Example Task, response, and explanation 


Task: Return to service the posted DTCI. 
Response: OK 


Explanation:The test passes and the PM is returned to service. 


Responses 


The following table provides explanations of the responses to the rts 
command. 


Responses for the rts command 


MAP output Meaning and action 


6X45 PEC MISMATCH 
<available_pecs> 


Meaning: The return to service cannot occur because the datafilled entry in the 
inventory table does not match the PEC of the NT6X45 card. If 
parameter nowait is entered, this response does not appear. While the 
table query is occurring, the maintenance flag ROM/RAM QUERY is 
displayed. The equipped PECs of NT6X45 cards are listed, where 
<available_pecs> is one or more card(s). If a question mark (?) is 
present instead of a PEC, the PEC can only be obtained by inspecting 
the appropriate card. 


Action: Check the PECs of the NT6X45 cards in use and ensure the one with 
the lowest suffix is the one datafilled in inventory Table LTCINV. 


ALL OPTION NOT SUPPORTED FOR LINK PARAMETER 


Meaning: The parameter all does not apply to links because links must be 
returned-to-service one at a time. 


Action: None 
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D-1030 DTCI level commands 
rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 
/CLEAR DATA 
Meaning: With feature package NTX270, DTCls do not undergo the second restart 
for command rts that other DTCs undergo. Therefore, the resetting of 
the static data occurs before the initial restart, and the system confirms 
that the static data is reset cleared. 
None 
/DISTRIBUTED DATA 
Meaning: With feature package NTX041, at least one DTC is being loaded while 
the command rts is in progress. The loading is required because of a 
mismatch of data between the DTC and the CC. 


Action: Depending on the result of the loading, a log is generated. 


FAILED TO SEND RESET MESSAGE 
<card_list> 


Meaning: An DTCI with an NT6X69 messaging card, returning to service cannot 
occur because a card is notreset. The card is one or more of the listed 
cards, where <card_list> is one of 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 
NT6X50 
NT6X69 


NT6X72 
Action: None 
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DTCI levelcommands D-1031 
rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 


FAILED TO SEND STATUS MESSAGE 
<card_list> 


Meaning: For a DTCI with an NT6X69 messaging card, returning to service cannot 
occur because a card is not communicating. The card is one or more of 
the listed cards, where <card_list> is one of the following: 


NT6X40 
NT6X41 
NT6X45 (MP) 
NT6X45 (SP) 
NT6X46 
NT6X47 


NT6X69 
Action: None 


INACTIVE PARAMETER NOT VALID FOR OOS PM 


Meaning: The parameter inactive does not apply to out-of-service DTCls. The 
DTCls must be in service. 


Action: The activity display for the DTCls is blank. To return the DTCl(s) to 
service, reenter the command rts with the parameter unit or pm. 


DTCI <pm_number> MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTCI cannot be returned to service because it is already 
undergoing maintenance action, where <pm_number> is the 
discrimination number of the DTCI. 


Action: |f parameter all is used, the DTCI is bypassed from the posted set of 
DTCls only while it is being returned to service. 
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D-1032 DTCI level commands 
rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 


DTCI <pm_number> REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: With the parameter all, a DTCI in the posted set cannot be returned to 
service because it is not in the ManB state. 


Action: The DTCI in the posted set is bypassed by the return to service. To 
proceed with the maintenance, wait until the action on the posted set is 


completed, then busy the DTCI with the command bsy before trying the 
command rts. 


DTCI <pm_number> UNIT <u> RTS PASSED 


Meaning: The tests are confirmed, where <pm_number> and <u> echo the 
discrimination numbers of the DTCI and its unit. 


Action: The DTCI or unit is made InSv. 


NO RESPONSE FROM PM AFTER ROMTEST 
<card_list> 


Meaning: A DTCI with an NT6X69 messaging card cannot be returned to service 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 
NT6X46 


NT6X47 
Action: None 
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DTCI levelcommands D-1033 
rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 


NO RESPONSE FROM PM AFTER STATUS 
<card_list> 


Meaning: An DTCI with an NT6X69 messaging card cannot be returned to service 
because a card is not communicating. The card is one or more of the 
listed cards, where <card_list> is one of 


NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X47 


NT6X69 
Action: None 


NO RESPONSE FROM ROM/RAM QUERY MESSAGE 


Meaning: The return to service cannot occur because the datafilled entry in the 
inventory table does not match the PEC of the NT6X45 card or because 
the ROM/RAM query is not answered. If parameter nowait is specified, 
this response does not appear. 


The maintenance flag ROM/RAM QUERY appears while the load is 
being queried. Check the PECs of the NT6X45 cards in use and ensure 
the one with the lowest suffix is the one datafilled in Table LTCINV. 


Menu Commands Reference Manual-DATA Through DTCI 
Volume 3 of 10 BCS36 and up 


D-1034 DTCI level commands 
rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


NO WAI RECEIVED AFTER RESET 
<card_list> 


Meaning: A DTCI with an NT6X69 messaging card cannot be loaded because a 
card is not present. The card is one or more of the listed cards, where 
<card_list> is one of 


NT6X40 

NT6X41 

NT6X45 (FP, International) 
NT6X45 (MP) 

NT6X45 (SP) 

NT6X46 

NT6X46 (FP, memory) 
NT6X47 

NT6X50 

NT6X69 


NT6X72 
Action: None 


Meaning: The test passes and the PM is returned to service. 


Action: None 


OSVCE TEST INITIATED 


Meaning: Out-of-service tests are being performed on the posted PM which is in 
the ManB or SysB state. 


Action: None 
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DTCI levelcommands D-1035 
rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


PM FAILED TO INITIALIZE 
TRY RELOADING THE PM 


Meaning: A DTCI with an NT6X69 messaging card cannot be returned to service 
because a card is not initialized. 


Action: Reload the XPM by entering the command pmreset or loadpm at the 
MAP. 


PM IS OFFLINE 
NO ACTION TAKEN 


Meaning: The command cannot be executed because the PM is in the Offl state. 


Action: None 


PM NOT LOADED SINCE POWER UP 


Meaning: The DTCI cannot be returned to service because it has not been loaded 
with software after having been powered up. If parameter nowait is 
entered, this response does not appear. 


Using the command querypm indicates the correct load for the NT6X45 
card. The system tries to auto-load the units before a return to service. 
When auto-loading fails, use the commands bsy and loadpm to busy 
and load the DTCI. 


The maintenance flag ROM/RAM QUERY appears while the load is 
being queried. Log PM181 records the occurrence of this response. 
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D-1036 DTCI level commands 
rts (continued) 


Responses for the rts command (continued) 
MAP output Meaning and action 


<pm_type> <pm_number> IS <status>. 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for returning to service, where 
<pm_type> is a PM listed in the PM status codes table in the PM MAP 
level chapter, <pm_number> is the discrimination number of the PM, 
and <status> is one of 


CBSY 
INSV 
OFFLINE 
The PM must be ManB. 


Action: None 


REPLACE CARDS IN CARDLIST 
<card_list> 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the return to service, where card_list is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


REQUEST INVALID 
DTCI <pm_number> IS <pm_state> 


Meaning: The state of one of the units of the DTCI prevents the whole PM from 
being put in service by using the command string rts pm force. Thatis, 
one unit may be ISTb. 


Action: None 
RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not include a list of cards 
suspected of being faulty. 


Action: Re-enter the command rts. 
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DTCI levelcommands D-1037 
rts (continued) 


Responses for the rts command (continued) 


MAP output Meaning and action 


RTS FAILED 
TRY THE RTS COMMAND ON ONE UNIT 


Meaning: A DTCI with an NT6X69 messaging card cannot be returned to service 
because both units are ManB or because a card is pulled. The units 
must be reloaded. 


Action: Use the command rts to reload the static data into the units. 


SUMMARY: 
<nnn> PASSED 
<nnn> NOT SUBMITTED 


Meaning: If the parameter all is used, the number (<nnn>) of DTCls in the posted 
set that have been successfully returned to service, or that have been 
bypassed by the return to service, is displayed. 


Action: None 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EQPEC 
<card_list> 


Meaning: Results of a failed test include a list of cards suspected of being faulty. 


Action: None 


THIS OPERATION WILL BE EXECUTED ON nnn DTCI 
PLEASE CONFIRM (“YES” OR NO”): 


Meaning: A quantity of nnn DTCls in the posted set is to be returned to service. 


Action: Entering yes tests, reloads, and then returns the DTCls to service. The 
status display of the DTCI in the current position of the posted set shows 
the maintenance flag “Mtce” while testing and loading is in progress, 
then changes from ManB or SysB to InSv without Mtce and the status 
display for the PM level increments under the header InSv and 
decrements under the header ManB, SysB, or CBsy. 


Entering no aborts the action. 
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D-1038 DTCI level commands 
rts (end) 


Responses for the rts command (continued) 
MAP output Meaning and action 
RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Reenter the command rts. 


**WARNING** UNIT <u> MAY NOT HAVE A VALID LOAD 


Meaning: A unit of a PM of node-type DTCI has undergone the ROM tests, where 
<u> is O or 1. The RAM load is erased. 


Action: Reload the unit using the command loadpm. 
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DTCI level commands D-1039 
swact 


Function 
Use the swact command to cause the posted DTCIs to switch the activity of 
the pairs of units (unit O and unit 1) from active to inactive. Units O and 1 
must be InSv or ManB. 


swact command parameters and variables 


Command Parameters and variables 


Parameters 
and variables Description 


This parameter simultaneously switches the activities of all DTCls of the same noq 
type as the DTCI in the current position of the posted set. 


Qualifications 
The swact command is qualified by the following exceptions, restrictions, 
and limitations: 


e If the DTCI is not ManB, confirmation, yes or no, is required. If the 
DTCI is ManB, no confirmation is required. 


e Log PM181 is generated when swact is executed. The log, that identifies 
the newly-active unit, is for information only and no alarm is invoked. 


Example 
The following table provides an example of the swact command. 


Examples of the swact command 


Example Task, response, and explanation 


swact J 


Task: Switch activity from active unit to inactive unit of posted DTCI. 


Response: DTCI 12 SWACT PASSED 


Explanation:Swact has been performed on DTCI 12. 
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D-1040 DTCI level commands 
swact (end) 


Responses 


The following table describes the responses to the swact command. 
Responses for the swact command 
MAP output Meaning and action 


A COLD SWACT WILL BE PERFORMED 
PLEASE CONFIRM (“YES” OR “NO”): 


Meaning: The DTCI is not ManB and the unlisted menu command warm swact is 
off. During a cold swact, both units are SysB and call processing is lost 
until the active unit is returned to service. A cold swact drops all calls. 


Action: If yes is entered the response is DTCI pm number SWACT PASSED 
which indicates that swact is executed. The newly-inactive unit 
becomes SysB and requires RTS to return it to the ready state. 


If no is entered the response is ACTIVITY DROPPED 
DTCI pm_number A WARM SWACT WILL BE PERFORMED. 


DTCI <pm_number> SWACT PASSED 


Meaning: The activity of the two DTCI units is switched, where <pm_number> is 
the discrimination number of the DTCI. 


Action: None 


REQUEST INVALID 
INACT UNIT MUST BE INSV OR BOTH UNITS MUST BE MANB 


Meaning: The units cannot be switched because one or both are in the wrong 
state. 


Action: None 
SWACT OPERATION NOT VALID ON OOS PM 


Meaning: When an XPM is in an out-of-service state (ManB, SysB, CBsy, or Offl), 
a switch of activity cannot occur. 


Action: The activity display for the XPMs is blank. 
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DTCI level commands D-1041 
trnsl 


Function 


Use the trnsl command to identify the C-side or P-side links of a posted 
DTCI and shows the status of the DS30 links to the Network C-side, or the 
DS30A or DS-1 links to subsidiary PMs P-side. 


trnsl command parameters and variables 


Command Parameters and variables 


side 
link_no 


Parameters 
and variables Description 


This variable identifies one link for the C-side. The range is O to 31. This variable 


also identifies one link for the P-side. The range is 0 to 19. If link_no is omitted, 
all the C-side or P-side links are displayed. 


This parameter specifies all the message links of the C- or P-sides of the DTCI. 


This variable is used to select the C-side or P-side links for display. The range is 
Cor P. C identifies the DS30 links that connect it to the Network. 


Qualifications 
None 
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D-1042 DTCI level commands 
trnsl (continued) 


Examples 
The following table provides examples of the trnsl command. 


Examples of the trnsl command (continued) 


Example Task, response, and explanation 


identifies the C-side links of the posted DTCI. 


Task: Identify the C-side links and show the status of the DS30 links to the 
Network. 


Response: 


NETO 
NET1 


LINK 0 O 10;CAP:MS;STATUS:OK ;MSGCOND:OPN, Unrestrict 
LINK 1 O 10;CAP:MS;STATUS:MBsy;MSGCOND:CLS, Unrestrict 
LINK 2 NETO O 11;CAP:MS;STATUS:OK ; 
LINK 3 NET1 O 11;CAP:MS; STATUS:MBsy; 
LINK 4 NETO 1 52;CAP:MS;STATUS:OK ;MSGCOND:OPN, Restricted 
LINK 5 NET1 1 52;CAP:MS;STATUS:OK ;MSGCOND:CLS, Restricted 


Explanation:In this example, there are four DS30 links (0-3) to NM-O and two 
links (4,5) to NM-1. DTCI-0 has been selected. 


trnsl pu 
where 


p identifies the P-side links of the posted DTCI. 


Task: Identify the P-side links and show the status of the DS30A or DS-1 
links to a subsidiary PM. 


Response: 


LINK LCMI 0 0;CAP:MS;STATUS:OK ;MSGCOND: 
LINK LCMI 0 1;CAP:MS; STATUS:MBsy; MSGCOND: 
LINK LCMI 0 2;CAP: S;STATUS:OK ;MSGCOND: 
1 
1 


LINK LCMI 0; CAP :MS; STATUS:MBsy; MSGCOND: 
LINK LCMI 1; CAP :MS; STATUS:OK 


Explanation:In this example, there are three (0-2) DS30A links to LCMI-0, and 
two links (3,4) to LCMI-1. DTCI-0 has been selected. 
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DTCI level commands D-1043 
trnsl (end) 
Response 


The following table provides an explanation of the response to the trnsl 
command. 


Response for the trnsl command 


MAP output Meaning and action 


display 


Meaning: The trnsl display appears. 


Action: None 
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Function 


DTCI level commands D-1045 
tst 


Use the tst command to test one or all units of one or all posted DTCIs, or 
tests one specified P-side link of the DTCI that is in the current position of 
the posted set. Testing the P-side link involves a message looparound test to 
the LCMI or LCME and back. DS-1 links are not tested The node under 
test must be InSv, ISTb, ManB, or SysB. 


tst command parameters and variables 


Command 


Parameters 
and variables 


Parameters and variables 


Lom] Las | 


unit_no 


Description 
This parameter simultaneously tests all of the specified units or DTCls of the same 


node type as the DTCI in the current position of the posted set. 


Note: With parameter all, the larger the quantity of XPMs to be tested concurrently, the longer it 
takes to complete the testing. Other maintenance activities must wait until completion. 


This parameter tests a specified P-side link between the posted DTCI and one of 
its associated LCMIs or LCMEs. 


This parameter requests immediate activation of REX tests regardless of the test 
schedule. If maintenance is in progress, testing cannot occur until it is completed. 


This parameter deactivates the REX tests already in progress, or has no effect if 
none are in progress. 


This default parameter activates the REX tests. 

This parameter displays the status of the REX tests. 

This parameter tests all units of one or all of the posted DTCls. 

This variable specifies which P-side link is to be tested. The range is 0 to 19. 


This parameter specifies that REX tests are to be controlled manually. 
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D-1046 DTCI level commands 
tst (continued) 


tst command parameters and variables (continued) 


Parameters 
and variables Description 


This parameter applies the ROM tests for the PM or unit. The units must be in the 
ManB state. The test erases the RAM load. 


ROM tests that are run on an inactive unit recognize the differences between the 
capabilities of the various NT6X45 cards. ROM tests for the BA version of the 
NT6X45 card are non-destructive. If the DTCI is out of service, the NT6X45BA tegts 
that are run when parameter ROM is not specified. 

While the ROM tests are running, the maintenance flag NONDESTR ROMTST is 
displayed. 

Log PM181 records when the DTCI is at the ROM level of maintenance. 


unit This parameter tests one unit of one or all of the posted DTCl(s). 


unit_no This variable specifies which unit of the posted DTCl(s) is to be tested. The range 
is 0 or 1. 


Qualifications 
The tst command is qualified by the following exceptions, restrictions, and 
limitations: 


e If the DTCI is ManB, the full test is preceded by a message looparound 
(pilot) test. 


e Units that have been tested by parameter ROM must be manually 
reloaded before being returned to service. 


e During the progress of maintenance testing, Mtce appears on the display 
beside the respective units. 

e When the warm swact command is disabled for an DTCI, a REX test in 
progress still allows the commands bsy, tst, and rts to be entered for the 
inactive unit. However, if the warm swact command is disabled before 
the REX test starts, and since the inactive unit must be in service. the test 
cannot be run. The command string tst rex now cannot be used. 

e The following logs are generated when the indicated maintenance 
actions occur: 

- PM128-The NT6X78 CMR card is out-of-service. Until the card is 
returned to service or replaced, the XPM cannot be tested by the 
in-service tests invoked by the command tst. 


- PM180-The NT6X78 CMR card has a fault and a reset has been or 
is being attempted. The testing has not occurred. 


- PM181-The NT6X78 CMR card has failed a card test. 
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DTCI level commands D-1047 
tst (continued) 


Example 
The following table provides an example of the tst command. 


Example of the tst command 


Example Task, response, and explanation 


tst unit 1 
where 


1 is the number of the unit to be tested. 
Task: Test unit one of the posted DTCI. 
Response: OK 


Explanation:Test of unit passes. 


Responses 
The following table describes the meaning and significance of responses to 


the tst command. 


Responses for the tst command 


MAP output Meaning and action 


6X45 PEC MISMATCH 
<available_pecs> 


Meaning: The tests cannot occur because the datafilled entry in the inventory table 
does not match the PEC of the NT6X45 card. 


Action: The equipped PECs of NT6X45 cards are listed, where available PECs 
is one or more card(s). If a question mark(?) is present instead of a 
PEC, the PEC can only be obtained by inspecting the appropriate card. 


Check the PECs of the NT6X45 cards in use and ensure the one with 
the lowest suffix is the one datafilled in Table LTCINV. 
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D-1048 DTCI level commands 
tst (continued) 


Responses for the tst command (continued) 
MAP output Meaning and action 


CS LINK UNAVAILABLE 
NO ACTION TAKEN 


Meaning: The C-side links used for messages are both out-of-service, therefore, 
the PM cannot communicate with the CC. 


Action: None 


INSVCE TESTS INITIATED 
DTCI <pm_number> TST PASSED 


Meaning: In-service testing is being performed on the posted PM which is in the 
InSv or ISTb state. “PASSED,” appears when testing is satisfactorily 
completed. 


Action: None 


LAST REX DATE WAS <day> <mmdd> AT <hh.mm>; <results> 
the response is displayed with: 

LTC pm_number IS INCLUDED IN THE REX SCHEDULE 

LTC pm_number IS REMOVED FROM THE REX SCHEDULE 


Meaning: With the command string tst rex query, the date of the last REX test is 
given where: 

<day> is an abbreviation for the day of the week, for example, MON 
for Monday 

<mmdd> is an abbreviation for tne month and includes the date of 
the day, for example, SEPO7 for September 7 

<hh.mm> denotes the time in hours and minutes the REX test 
occurred 

<results> gives the results of the last REX test (PASSED or FAILED) 


Action: None 
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DTCI level commands D-1049 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


NON-DESTRUCTIVE ROM TEST AND 
OSVCE TESTS WILL BE RUN 


Meaning: The non-destructive tests occur for both the in-service and out-of-service 
unit or XPM. 


The maintenance flag NONDESTR ROM TST appears while testing 
occurs. 


Log PM181 records when the XPM is at the ROM level of maintenance. 
Action: Wait for the tests to complete. If the tests fail, check the PECs of the 
NT6X45 cards in use and ensure that the one with the lowest suffix is 
the one datafilled in Table LTCINV. 
NON-DESTRUCTIVE ROM TEST WILL BE RUN 


Meaning: The non-destructive tests occur for the in-service unit or PM. 


The maintenance flag NONDESTR ROMTST appears while testing 
occurs. 


Wait for the tests to complete. If the tests fail, check the PECs of the 
NT6X45 cards in use and ensure that the one with the lowest suffix is 
the one datafilled in Table LTCINV. 


NO PM POSTED 


Meaning: The PM must be posted before using the tst command. Posting a PM 
identifies to the system the PM for maintenance action. 


Action: None 
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D-1050 DTCI level commands 
tst (continued) 


Responses for the tst command (continued) 
MAP output Meaning and action 
NO RESPONSE FROM ROM/RAM QUERY MESSAGE 
Meaning: Testing cannot occur because the datafilled entry in the inventory table 
does not match the PEC of the NT6X45 card or because the ROM/RAM 


query is not replied to. 


The maintenance flag ROM/RAM QUERY appears while the load is 
being queried. 


Log PM181 records when the XPM is at the ROM level of maintenance. 


Action: Check the PECs of the NT6X45 cards in use and ensure the one with 
the lowest suffix is the one datafilled in Table LTCINV. 


Meaning: The tests pass. 


Action: None 


OSVCE TESTS INITIATED 
DTCI <n> UNIT <n> TST PASSED 


Meaning: One unit of the DTCI has been tested, where <n> is the respective 
discrimination number. If both units are tested, the response occurs for 
each unit. 


Action: None 


DTCI <pm_number>, CHECKSUM=# <hhh>, AGREES. 
OK 


Meaning: The TST passes. The checksum agreement referred to “AGREES” is 
between a recent value for the data in the PM and the load-time value as 
stored in the CC. This confirms the PM load has not been completed. 


Action: None 
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DTCI level commands D-1051 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


DTCI <pm_number> IS <rex_status> 


Meaning: The REX tests are activated, deactivated, or queried, where 
<rex_status> is either: 


JINCLUDED IN THE REX SCHEDULER 
or 


REMOVED FROM THE REX SCHEDULER. 


Action: None 


<pm_type> <pm_number> IS <status> 
NO ACTION TAKEN 


Meaning: The PM is in the incorrect state for testing, where <pm_type> is aPM 
listed in the PM status codes table in the PM MAP level chapter, 
<pm_number> is the discrimination number of the PM, and <status> is 
CBsy or Offl. The PM must be ManB. 


Action: None 


DTCI <pm_number> MTCE IN PROGRESS ON EITHER OR BOTH UNITS 


Meaning: The DTCI cannot be tested because it is already undergoing 


maintenance action, where <pm_number> is the discrimination number 
of the DTCI. 


Action: |f parameter all is used, the DTCI is bypassed from the posted set of 
DTCls only for the duration of the testing. 


DTCI <pm_number> REQUEST INVALID 
MANUAL ACTION ONLY VALID ON MANB PM 


Meaning: If parameter all is used, a DTCI in the posted set cannot be tested 
because it is not in the ManB state. 


Action: The DTCI in the posted set is bypassed by the testing. To proceed with 
the maintenance, wait until the action on the posted set is completed, 


then make the DTCI busy with the command bsy before trying the 
command tst. 
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D-1052 DTCI level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


REPLACE CARDS IN CARDLIST: 
<card_list> 


Meaning: The results of the tests by the mate unit indicate that cards are 
preventing the loading, where <card_list> is the list of cards. 


Action: Replace the cards. If one of them is a processor card, reload the unit. 


REQUEST INVALID 


Meaning: The in-service tests occur if the selected PM is in the InSv state, or 
out-of-service tests occur if it is in the ManB or SysB state. 


Action: None 
RETRY LAST COMMAND 


Meaning: The results of the tests by the mate unit do not have a list of suspected 
cards. 


Action: Reenter the command tst. 


REX REQUEST INVALID: MTCE IN PROGRESS 


Meaning: A REX test cannot be started on the PM because other maintenance 
actions are already in progress. 


Action: None 


REX TEST IN PROGRESS 


Meaning: A REX test has already been activated. When the test is completed, its 
status is REX TEST PASSED Of REX TEST reason. 


Action: None 
REX TEST PASSED 
Meaning: The REX test is successful. 


Action: None 
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DTCI levelcommands D-1053 
tst (continued) 


Responses for the tst command (continued) 
MAP output Meaning and action 
REX TEST <reason> 


Meaning: The REX test failed or is incomplete because of one of the following 
reasons: 


Failed-Achieving Superframe/Data Sync after SwAct 


Failed-Inactive OOS tests 
Failed-Inactive RTS 

Failed-Inactive OOS tests after SwAct 
Failed-Inactive RTS after SwAct 
Failed-Warm SwAct 

Terminated-at least one unit is ISTb 
Terminated-inactive unit is Bsy 
Terminated-overload conditions detected 


Terminated-warm SwAct turned off 
Action: None 


SUMMARY : 
<nnn> PASSED 
<nnn> NOT SUBMITTED 


Meaning: If parameter all is used, a summary is given of the quantity (<nnn>) of 
DTCls in the posted set that have been successfully tested or that have 
been bypassed by the testing. 


Action: None 


TESTED CMR 
Meaning: The NT6X78 CMR card is tested. 


Action: None 
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D-1054 DTCI level commands 
tst (continued) 


Responses for the tst command (continued) 


MAP output Meaning and action 


TEST FAILED 
SITE FLR RPOS BAY_ID SHF DESCRIPTIONS SLOT EOPEC 
<card_list> 


Meaning: Results of tests include a list of cards suspected of being faulty. 


Action: None 


TEST RESOURCES IN USE 
NO ACTION TAKEN 


Meaning: Test facilities are already temporarily in use for other maintenance 
actions. 


Action: None 


THE ROM TEST IS DESTRUCTIVE 
THE RAM LOAD WILL BE LOST FOR UNIT <u> 
(PLEASE CONFIRM “YES” OR “NO”): 


Meaning: The RAM load is erased in the unit because of the ROM test, where <u> 
isOor 1. 


Action: To replace the RAM load the units must be reloaded by the command 
loadpm. 


THIS OPERATION WILL BE EXECUTED ON <nnn> LTC 
(PLEASE CONFIRM “YES” OR “NO”): 


Meaning: A quantity of <nnn> DTCls in the posted set is to be tested. 


Action: Enter yes to test the DTCI(s). The status display of the DTCI in the 
current position of the posted set shows the maintenance flag Mtce while 
testing is in progress. 


Enter no to abort the action. 
TRY PMRESET 


Meaning: For DTCIs with an NT6X69 messaging card, testing cannot occur 
because the static data must be reloaded. 


Action: Use the command pmreset. 


297-1001-821 Standard 04.01 June 1999 


DTCI level commands D-1055 
tst (end) 


Responses for the tst command (continued) 


MAP output Meaning and action 


UNABLE TO DIAGNOSE FROM MATE 
MATE NOT ACT/INSV - TRY AGAIN LATER 


Meaning: Testing by the mate test is cancelled if the status or the activity of the 
active unit changes. 


Action: Wait for the changes to be completed. 


UNABLE TO DIAGNOSE FROM MATE 
NO RESOURCES - TRY AGAIN LATER 


Meaning: Testing by the mate unit cannot occur when key software modules are 
missing. 


Action: Wait for the resources to become available. 


UNABLE TO DIAGNOSE FROM MATE 
MATE MTCE IN PROGRESS - TRY AGAIN LATER 


Meaning: Testing from the mate unit cannot occur when maintenance is in 
progress. 


Action: Wait for the maintenance actions to be completed. 
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DTCI level commands D-1057 
warmswact 


Function 
Use the warmswact command to switch the activity states of the XPM units 
of the posted DTCI. 


Note: If an attempt to change the warmswact capability is made while a SwAct 
is in progress, a message will be displayed stating the attempt is disallowed and 
no action will be taken. 


warmswact command parameters and variables 
Command Parameters and variables 


warmswact off fi noprompt 
on 


query 


Parameters 
and variables Description 


This parameter includes all XPM units of the posted set. 


This parameter is used to avoid confirmation requests for each unit affected when 
command string warmswact on all is entered. 


This parameter cancels the automatic switching of the activity states of the XPM 
units. 


This parameter allows the automatic switching of the activity states of the XPM 
units. 


This parameter gives the status of warmswact as on or off. 


Qualifications 


The warmswact command is qualified by the following exceptions, 
restrictions, and limitations: 


e When the command string warmswact on is executed, calls in process 
are maintained when the activity states of the units are switched. 


e When the command string warmswact off is executed, calls in process 
are dropped when the activity states of the units are switched. 
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D-1058 DTCI level commands 
warmswact (end) 


Example 
The following table provides an example of the warmswact command. 


Example of the warmswact command 


Example Task, response, and explanation 
warmswact J 


Task: Switch activity from the active to the inavtive unit on the posted DTCI. 
Response: WARM SWACT FOR DTCI 2 UNIT 1 IS OK. 


Explanation:The warm swact is completed. 


Response 


The following table provides an explanation of the response to the 
warmswact command. 


Response for the warmswact command 


MAP output Meaning and action 


WARM SWACT FOR DTCI <n> UNIT <n> IS <status> 


Meaning: If the command swact (menu item 13) is used, a warm SwAct occur, 
where <n> is the discrimination number of the DTCI and unit. 


Action: None 
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DTCI level commands D-1059 
xpmlogs 


Function 


Use the xpmlogs command to enable logs to be generated from the XPM of 
the DTCI and reports internal XPM software errors (SWERRS). 


xpmlogs command parameters and variables 


Command Parameters and variables 


xpmlogs 


Parameters 
and variables Description 


This parameter prevents logs from being printed. 
This parameter enables logs to be printed. 


This parameter gives the status of XPM_LOGS as ON or OFF. 


Qualification 


The command xpmlogs is cancelled by the default settings of a reload or 
restart. 


Example 
The following table provides an example of the xpmlogs command. 


Example of the xpmlogs command 


Example Task, response, and explanation 


xpmlogs on .| 


Task: Turn log reporting on for the posted DTCI. 


Response: DTCI 12 UNIT 0 XPMLOGS PASSED 
DTCI 12 UNIT 1 XPMLOGS PASSED 


Explanation:Logs will be generated for DTCI 12. 
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D-1060 DTCI level commands 
xpmlogs (end) 


Responses 


The following table provides explanations of the responses to the xpmlogs 
command. 


Responses for the xpmlogs command 
MAP output Meaning and action 
DTCI <n> UNIT <n> XPMLOGS PASSED 


or 
DTCI <n> UNIT <n> XPMLOGS PASSED 


Meaning: The response occurs in pairs, one for each DTCI or DTCI unit. It applies 
to either ON or OFF. 


Action: None 


LOGS FROM XPM ARE DISABLED 
or 
LOGS FROM XPM ARE ENABLED 


Meaning: The status of XPMLOGS is given. A log is produced when the xpmlogs 
command is enabled. 


Action: None 
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